Заголовки

Синтаксис

Символы # в начале строки создают заголовки:

## Раздел
### Подраздел
#### Пункт

Верхний уровень принадлежит названию

Одно правило специфично для LibreTimes: тело документа никогда не рендерит заголовок верхнего уровня. Название, введённое при публикации, – это <h1> страницы; заголовки тела начинаются со второго уровня.

Начинайте структуру с ##. Если документ пришёл с заголовками # (например, импортирован), он всё равно отрендерится правильно: при наличии любого заголовка # всё дерево заголовков сдвигается на один ранг вниз – # становится ##, ## становится ### и так далее. Иерархия сохраняется, а не сплющивается.

Глубина заголовков заканчивается на четвёртом уровне. Всё более глубокое (#####, ######) прижимается к четвёртому – там же останавливается панель редактора. Если нужна структура глубже, документ обычно просится разделиться, а не углубиться.

Якоря

Каждый заголовок автоматически получает якорь, выведенный из его текста, и сам является ссылкой на него – наведите курсор на заголовок любой публикации и кликните, чтобы скопировать глубокую ссылку. Ссылка на заголовок в том же документе – через фрагмент:

Смотрите [Якоря](#якоря) ниже.

Идентификатор – текст заголовка в нижнем регистре, пробелы заменены дефисами, пунктуация опущена. Нелатинские заголовки сохраняют свою письменность (## Введение получает якорь #введение). Повторяющиеся заголовки получают суффиксы -1, -2, ...

Setext-заголовки

Двухстрочная форма с подчёркиванием – корректный CommonMark и работает, но домашний стиль – форма с #:

Название раздела
================

Подчёркивание из = соответствует верхнему уровню (и потому сдвигается вниз, как любой заголовок #); - соответствует второму уровню.