Секции

Назначение

Секции — это основной структурный элемент документа, тот уровень, на котором задаётся, из каких крупных частей он состоит и как эти части будут выглядеть в Word. Через секции определяется логическая структура документа, привязка к соответствующим Word-шаблонам, места разрывов страниц, а также смена полей, колонтитулов и стилей внутри одного файла.

Ключевая идея простая: каждая секция документа напрямую сопоставляется с секцией, которая заранее настроена в шаблоне оформления. Вы в тексте лишь указываете, к какой секции относится тот или иной фрагмент, а всё остальное — как это будет выглядеть — уже решено на уровне шаблона. Подробнее о том, как секции устроены в шаблоне, можно почитать в разделе «Секции шаблона».

Формат объявления секции

Секция в Markdown обозначается парой маркеров — началом и концом:

[Section]: SectionName

Текст секции

[EndSection]: -

Здесь SectionName — это алиас секции, заданный в шаблоне оформления. Всё содержимое между маркерами [Section] и [EndSection] относится к данной секции целиком, включая заголовки, списки, таблицы и любые другие блоки. Секции можно объявлять несколько раз в пределах одного документа — например, если вам нужно вернуться к «Основной части» после отдельной секции с приложением.

Важно

Алиас секции обязан существовать в шаблоне, к которому привязан документ. Если документ ссылается на несуществующую секцию, рендеринг завершится ошибкой — система не будет угадывать, как оформить неизвестную секцию.

Практические замечания

На практике при работе с секциями стоит помнить несколько вещей.

Во-первых, порядок секций в Markdown напрямую определяет порядок секций в итоговом Word-документе — переставили секции местами в тексте, значит, переставили их и в файле. Во-вторых, секции — это не просто «контейнеры» для текста, а настоящие точки смены форматирования: именно на границе секций Word применяет новые поля, ориентацию страницы или колонтитулы. И наконец, изменение шаблона само по себе не меняет уже написанный документ — если вы добавили или переименовали секцию в шаблоне, существующий текст продолжит ссылаться на прежние алиасы, пока вы не поправите его вручную.