---
title: " Импорт макросов Confluence"
id: "importing-confluence-macros"
project: "Руководство пользователя Документерры"
url: "https://docs.documenterra.ru/articles/manual/importing-confluence-macros"
updated: 2026-11-16T06:45:53Z
---

#  Импорт макросов Confluence

В данной статье описывается, как Документерра обрабатывает макросы Confluence в процессе импорта.

* [Поддерживаемые макросы](/articles/manual/importing-confluence-macros/a/h2_617568882)
* [Неподдерживаемые макросы](/articles/manual/importing-confluence-macros/a/h2__165432133)
* [Особенности импорта макроса Excerpt](/articles/manual/importing-confluence-macros/a/h2__451114712)

##  Поддерживаемые макросы

Все поддерживаемые макросы Confluence будут автоматически преобразованы в соответствующие элементы системы Документерра или обработаны с сохранением их контента. Ниже приведен список поддерживаемых макросов:

| Макрос Confluence | Элемент Документерры | Комментарий |
| --- | --- | --- |
| Якорь (точка привязки гипертекстовой ссылки) | [Якорь](/articles/manual/vstavka-ssylok/a/h2_3) |  |
| Отображение дочерних страниц | [Связанные статьи](/articles/manual/spisok-svyazannykh-statey) |  |
| Блок кода | [Блок кода](/articles/manual/vydeleniye-koda) |  |
| Условный контент | [Условный контент](/articles/manual/dynamic-conditional-content) | Часть функционала [Версий разделов](https://marketplace.atlassian.com/apps/1210818/scroll-versions-for-confluence). [Условные страницы с Вариантами](https://help.k15t.com/scroll-docs/3.38/cloud/define-conditional-content) импортируются как страницы с [условными тегами,](/articles/manual/uslovnyye-tegi) созданными из примененных к ним вариантов. |
| Decision | [Экспресс-блоки](/articles/manual/ekspress-bloki) | Импортируется как **Информационный блок** с другим цветом фона. |
| Error | [Экспресс-блоки](/articles/manual/ekspress-bloki) | Импортируется как **Блок Ошибки**. |
| Цитата (Excerpt и Excerpt Include) | [Сниппеты контента](/articles/manual/content-snippets) | Об особенностях импорта фрагментов можно узнать [ниже](/articles/manual/importing-confluence-macros/a/h2__451114712). |
| Развернуть | [Выпадающий текст](/articles/manual/vypadayushchiy-tekst) |  |
| Скрыть, если / Показать, если | [Условный контент](/articles/manual/dynamic-conditional-content) | Импортируется как [Включающий/Исключающий блок](/articles/manual/dynamic-conditional-content/a/h2__562523176), преобразующий [группы пользователей](https://confluence.atlassian.com/doc/confluence-groups-139478.html) в [условные теги](/articles/manual/uslovnyye-tegi). |
| Горизонтальная линия | Горизонтальная линия |  |
| Информация | [Экспресс-блоки](/articles/manual/ekspress-bloki) | Импортируется как **Информационный блок**. |
| Примечание | [Экспресс-блоки](/articles/manual/ekspress-bloki) | Импортируется как **Информационный блок**. |
| Панель | — | Импортируется [как HTML-элемент &lt;p&gt;](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/p) с сохранением своих стилей, таких как размер шрифта, стили границ, цвет фона и т.д. |
| Успех | [Экспресс-блоки](/articles/manual/ekspress-bloki) | Импортируется как **Успешный блок**. |
| Совет | [Экспресс-блоки](/articles/manual/ekspress-bloki) | Импортируется как **Информационный блок**. |
| Дерево страниц | [Оглавление статьи](/articles/manual/oglavleniye) | Инлайн стили, такие как list-style-type,indent и т. д. не сохраняются.<br> <br>Макрос **Зона Дерева страниц** не поддерживается. |
| Уведомление | [Экспресс-блоки](/articles/manual/ekspress-bloki) | Импортируется как **Блок Предупреждения**. |

## Неподдерживаемые макросы

На шаге 3 [Мастера импорта из Confluence](/articles/manual/confluence-import-wizard) есть параметр **Обработка неподдерживаемых макросов**. Данная настройка позволяет выбрать способ обработки неподдерживаемых макросов: **Удаление неподдерживаемых макросов** или **Замена неподдерживаемых макросов плейсхолдерами**.

![Параметр Обработки неподдерживаемых макросов в Мастере импорта проектов](/resources/Storage/manual/documenterra_baselang/Screenshots/importing-confluence-macros/unsupported-macros-processing.png)

Ниже описано, как работают эти два варианта.

### Удаление неподдерживаемых макросов 

Неподдерживаемые макросы будут обработаны следующим образом:

* Если макрос не содержит контента, он будет удален.
* Если макрос содержит контент, будет импортирован только данный контент. Контейнер макроса будет удален.

| Параметр **Удаление неподдерживаемых макросов** является рекомендуемым способом обработки. |
| --- |

### Замена неподдерживаемых макросов плейсхолдерами

Выбор данного параметра приведет к сохранению неподдерживаемых макросов и помещению их контента в контейнеры &lt;div&gt; или &lt;span&gt;. Тег &lt;div&gt; используется для макроса с контентом, а &lt;span&gt; — для макроса без контента.
 
Вот HTML-пример того, как выглядит неподдерживаемый макрос без контента после импорта, если выбран параметр **Замена неподдерживаемых макросов плейсхолдерами**:


```html
<span unknown-macro-name="status" unknown-macro-attribute="{&quot;colour&quot;:&quot;Green&quot;,&quot;title&quot;:&quot;Test&quot;}">
</span>
```


* Атрибут unknown-macro-name содержит имя макроса.
* Атрибут unknown-macro-attribute содержит настройки макроса, которые использовались в системе Confluence.

Разметка для макроса с контентом аналогична, за исключением обязательного использования тега &lt;div&gt; и контента макроса, помещенного в данный контейнер.

После импорта вы всегда можете использовать функцию [Глобального поиска и замены](/articles/manual/globalnyy-poisk-i-zamena) для выполнения очистки импортированных неподдерживаемых макросов.

## Особенности импорта макроса Excerpt

Макросы Цитата (Excerpt) импортируются в Документерру в виде [Сниппетов](/articles/manual/content-snippets). Однако существует два различных сценария обработки данных макросов:

* **Макрос Цитата составляет весь контент Страницы.** Страница импортируется как одна страница и помещается в папку **Сниппеты**.
* **Макрос Цитата составляет часть контента Страницы.** Одна страница импортируется как две: контент Цитаты импортируется как отдельная страница, которая помещается в папку **Сниппеты**, а остальная часть контента импортируется как «основная» страница; страница, созданная из Цитаты, затем вставляется в «основную» страницу в виде сниппета.