Опубликовано март 2026

Автоматическое оглавление для Markdown

Длинным Markdown-файлам нужна навигация. Оглавление, сгенерированное из заголовков, делает любой документ удобным для просмотра. ShowMeMyMD генерирует его автоматически — без тегов, без плагинов, без CLI-инструментов.

## Проблема

В Markdown нет встроенного оглавления

В Markdown нет синтаксиса для оглавления. В спецификации нет тега [TOC]. Некоторые инструменты его поддерживают, большинство -- нет.

Поэтому люди ищут обходные пути. CLI-генераторы, такие как markdown-toc и doctoc, вставляют Markdown-оглавление в файл. VS Code имеет расширения для этого. GitHub автоматически генерирует его для README-файлов на веб-сайте.

Ничто из этого не автоматическое. Вы либо изменяете файл, либо устанавливаете инструмент. А когда вы меняете заголовок, оглавление устаревает, пока вы не запустите что-то снова.

## Как ShowMeMyMD это делает

Откройте файл. Оглавление уже там.

Откройте любой .md файл с заголовками — # до ###### — и ShowMeMyMD автоматически сгенерирует кликабельное оглавление.

Никаких тегов. Никаких плагинов. Никаких CLI-инструментов. Никакой конфигурации. Просто откройте файл и навигируйте.

Ключевая деталь

Оглавление генерируется во время рендеринга. Ваш .md файл никогда не изменяется. Измените заголовок, и оглавление мгновенно обновится при следующем открытии файла.

## Почему это важно

Длинным документам нужна навигация

Любой документ со структурой выигрывает от кликабельного оглавления. Переходите к нужному разделу вместо прокрутки сотен строк.

README-файлы

Open-source проекты с разделами установки, использования, API-документации и вклада. Переходите прямо к нужному разделу.

Документация

Технические спецификации, API-справочники, runbook-и. Оглавление превращает стену текста в навигируемый ресурс.

Заметки со встреч

Пункты повестки, решения, задачи. Найдите решение прошлой недели, не перечитывая весь документ.

Технические спецификации

Архитектурные решения, дизайн-документы, RFC. Навигируйте сложные документы по разделам.

## Альтернативы

Другие способы получить оглавление для Markdown

Ручное оглавление

Вручную пишите Markdown-ссылки на якоря заголовков. Что-то вроде [Installation](#installation) для каждого раздела. Утомительно писать, ломается при изменении заголовков, и вы должны поддерживать его сами.

markdown-toc (npm)

CLI-инструмент, который генерирует оглавление и вставляет его как Markdown-текст в файл. Работает, но требует Node.js, npm install и перезапуска команды при каждом изменении заголовков. Изменяет исходный файл.

Расширения VS Code

Несколько расширений VS Code добавляют генерацию оглавления. Они работают внутри VS Code, но вам нужен VS Code — полная IDE только для навигации по документу.

GitHub

GitHub автоматически генерирует оглавление для README-файлов на веб-сайте. Нажмите на иконку-гамбургер рядом с именем файла. Но это работает только на GitHub.com — не для локальных файлов на вашем Mac.

## Простой способ

Просто откройте файл

ShowMeMyMD генерирует оглавление из заголовков автоматически. Без изменения файлов. Неразрушающе. Работает с любой структурой заголовков от # до ######.

Оглавление всегда актуально, потому что генерируется из файла в его текущем состоянии — не из кэшированного снимка или вставленного блока, который может устареть.

## Читайте далее

Хватит прокручивать. Начните навигировать.

$2.99. Разовая покупка. Без подписки. Без аккаунта.

Загрузить вMac App Store