Appearance
Заголовки
Заголовки в документе пишутся в стандартном синтаксисе Markdown, без каких-либо дополнительных расширений или специальной разметки — если вы хоть раз видели Markdown, этот синтаксис будет вам знаком:
md
# Заголовок первого уровня
## Заголовок второго уровня
### Заголовок третьего уровняРоль заголовков
Заголовки — это не просто визуально выделенный текст, а основа всей структуры документа. На их основе формируется практически всё, что делает документ «умным»: строится автоматическое оглавление, применяется сквозная нумерация разделов, а также определяется иерархия глав, параграфов и подпунктов, по которой система понимает, что чему подчинено.
Именно поэтому иерархию заголовков стоит выстраивать осмысленно с самого начала работы над текстом, а не «выравнивать» её в конце. Каждый уровень заголовка — это шаг вниз по структуре документа, и от того, насколько аккуратно вы его соблюдаете, зависит корректность автоматически собираемого оглавления.
Рекомендация
Используйте заголовки строго иерархично, не пропуская уровни. Переход сразу от # к ###, минуя ##, ухудшает читаемость исходного текста и может привести к неожиданному виду оглавления — раздел третьего уровня окажется «подвешен» без родителя второго уровня.