---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://3y3.dev/en/syntax/includes.md
  - https://3y3.dev/ru/syntax/includes.md
  - href: ru/syntax/includes.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
updatedAt: '2026-02-06T07:01:08.000Z'
---
> **Documentation Index:** Fetch the complete configuration index at https://3y3.dev/ru/llms.txt

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

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

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

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

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

   {% note warning %}

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

   {% endnote %}

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

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

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

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

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

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

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

## Переиспользование части статьи {#include-headers}

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

### Пример

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

```markdown

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

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

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

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

```

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

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

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

{% note warning %}

С помощью конструкции `include` нельзя добавлять статью (или части статьи) саму в себя.

{% endnote %}