Переиспользование контента

Вы можете вынести повторяющийся контент в отдельный файл и добавлять его в нужные места в документе с помощью конструкции {% include %}.

Переиспользование поможет сократить время на редактирование и поиск исходного текста: информация хранится только в одном месте, а изменения автоматически применяются ко всем файлам.

Порядок переиспользования

1. Создайте каталог для хранения повторяющегося контента. Например, _includes.

   Важно

   Файлы для переиспользования должны храниться в каталоге, имя которого начинается с символа _, иначе они будут удалены при сборке.

2. В каталоге _includes создайте отдельный md-файл с повторяющимся текстом.

3. В разделы документа, куда необходимо подставить текст, добавьте ссылку на файл в формате:

   {% include [Описание](../_includes/file-f6915d7fa2f4.md) %}
   

   • [Описание] — описание файла. Информация для авторов документа, не влияет на сборку.
   • (_includes/file.md) — путь до файла.

   Если заголовок файла для переиспользования не нужно добавлять в текст раздела, добавьте ключевое слово notitle:

   {% include notitle [Описание](../_includes/file-f6915d7fa2f4.md) %}
   

При сборке документа текст файла будет добавлен в разделы на места инклюдов. Если в файле есть относительные ссылки, они будут перестроены.

Переиспользование части статьи

Можно переиспользовать отдельный раздел статьи, указав его якорную ссылку в {% include %}. В итоговый файл будет добавлен раздел и все подразделы статьи.

Пример

Файл file.md имеет вид:

## Часть 1
Контент первой части.

## Часть 2 {#part}
Контент второй части.

### Подраздел части 2
Контент подраздела.

## Часть 3
Контент третьей части.

Использование {% include [Описание](file.md#part) %} добавит в статью раздел "Часть 2" и его подраздел:

## Часть 2 {#part}
Контент второй части.

### Подраздел части 2
Контент подраздела.