---
title: "Особенности импорта из ReadMe"
id: "osobennosti-importa-iz-readme"
project: "Руководство пользователя Документерры"
url: "https://docs.documenterra.ru/articles/manual/osobennosti-importa-iz-readme"
updated: 2026-11-16T06:45:55Z
---

# Особенности импорта из ReadMe

На этой странице вы найдете подробности о специфике импорта из ReadMe — какие элементы поддерживаются, какие нет и что происходит со структурой Дерева страниц.

## Специфика импорта структуры дерева страниц

При импорте проекта из ReadMe в Документерру иерархия папок в оглавлении сохраняется, но порядок страниц — нет, поскольку экспортированный архив не включает такую информацию. При необходимости вы можете вручную [изменить порядок страниц](/articles/manual/organizatsiya-stranits-v-dereve-stranits) после импорта.

## Поддерживаемые элементы ReadMe

| Под "поддерживаемыми" элементами мы имеем в виду элементы, специфичные для ReadMe. Обычные элементы, такие как абзацы текста, ссылки, изображения и т. д., здесь не упоминаются, так как они импортируются как есть. |
| --- |

Во время импорта Документерра обрабатывает и конвертирует следующие элементы в элементы Документерры:

| Элемент ReadMe | Элемент Документерры | Комментарий |
| --- | --- | --- |
| [Code blocks](https://docs.readme.com/rdmd/docs/code-blocks) | [Примеры кода](/articles/manual/vydeleniye-koda) |  |
| [Callouts](https://docs.readme.com/rdmd/docs/callouts) | [Экспресс-блоки](/articles/manual/ekspress-bloki) |  |
| [Embeds](https://docs.readme.com/rdmd/docs/embeds) | — | Вставляются как HTML тег &lt;iframe&gt; |
| Page Description | — | Вставляется как HTML тег &lt;p&gt; с CSS классом description. Тег включает содержимое поля Description страницы ReadMe, если оно не пустое. |
| Tabs | [Вкладки](/articles/manual/vstavka-vkladok) |  |

##  Неподдерживаемые элементы ReadMe

Элементы, которые в настоящее время не поддерживаются, импортируются с сохранением их HTML-разметки и содержимого, насколько это возможно. Конкретная функциональность элемента или некоторые части контента могут быть утеряны. Зная разметку, вы сможете найти их с помощью инструмента [Глобального поиска и замены](/articles/manual/globalnyy-poisk-i-zamena) и исправить.

## Импортирование API документации

В настоящее время автоматический импорт определений API из ReadMe не поддерживается, так как экспортированный архив не включает файл Swagger/OpenAPI или ссылку на него. Справочник API импортируется в виде стандартных страниц. Если страница в проекте ReadMe включает дополнительную информацию, добавленную вручную в теле документации, она также импортируется.

Если вам нужно импортировать ваш файл определения Swagger/OpenAPI в систему Документерра, пожалуйста, обратитесь к этой статье: [Импорт спецификаций OpenAPI/Swagger](/articles/manual/import-opredeleniy-openapi-swagger).