---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://diplodoc.com/docs/ru/extensions.md
  - href: ru/extensions/index.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
description: Как устанавливать и подключать расширения Diplodoc.
updatedAt: '2025-11-23T15:31:42.000Z'
---
> **Documentation Index:** Fetch the complete configuration index at https://diplodoc.com/docs/ru/llms.txt


# Расширения Diplodoc

Расширения предназначены для дополнения функциональности Diplodoc новыми возможностями.

## Установка {#install}

Перед использованием расширения его необходимо загрузить. Это можно сделать с использованием `npm` через команду `npm install ...` или сохранив локально файлы расширения, что подходит – в том числе – для использования расширений [собственной разработки](https://diplodoc.com/docs/ru/dev/extensions-api.md).

Пример — установка расширения для [подключения Algolia](https://diplodoc.com/docs/ru/project/algolia.md):
```
npm install @diplodoc/algolia-extension
```

## Подключение {#usage}

Подключить расширение к проекту можно одним из двух способов:

1. Прописав его в `.yfm` проекта в [параметре](https://diplodoc.com/docs/ru/settings.md#extensions) ##extensions##:
    ```yaml
    extensions:
        - @diplodoc/algolia-extension
        - /local/path/to/extension
    ```
2. Передав через параметр `-e` при вызове `yfm`:
    ```
    yfm build -e @diplodoc/algolia-extension
    ```

{% note info %}

Если расширение прописано для подключения, но недоступно, команда `yfm` будет выполнена с ошибкой.

Если расширение не подключено при выполнении команды yfm, но необходимо для корректной обработки проекта, команда `yfm` может быть выполнена с корректным кодом ответа, но с непредсказуемым результатом.

{% endnote %}

## Встроенные расширения {#built-in}

В Diplodoc встроено несколько расширений в качестве примеров работы Extensions API:

#|
|| **Название** | **Описание** ||
||
`github-vcs`
|
Получает информацию о [дате изменения](https://diplodoc.com/docs/ru/settings.md#vcs-mtimes) и [авторах](https://diplodoc.com/docs/ru/settings.md#vcs-authors) из репозитория Github при сборке проекта для размещения в контенте статей.
||
||
`mdit-plugins`
|
Добавляет в парсер markdown-it [дополнительные плагины](https://diplodoc.com/docs/ru/plugins/index.md) для расширения возможностей разметки документации.
||
|#