# Экспорт и импорт контента

BookStack позволяет экспортировать контент в различные форматы, а также предоставляет несколько вариантов импорта контента. Обратите внимание, что эти опции не предназначены для резервного копирования или восстановления данных, для которых существует соответствующая документация.

#### Экспорт

Если у вас есть необходимое разрешение роли «Экспорт контента», вы можете экспортировать книги, главы или страницы в следующих форматах:

- **Контейнерный веб-файл**  
    Файл .html, в который, где возможно, встроены изображения. Такой файл можно открыть в веб-браузере.  
    Этот формат обычно обеспечивает наилучшее представление контента BookStack.
- **PDF-файл**  
    Документ в формате .pdf, представляющий ваш контент.  
    Выходной файл иногда может быть неточным или лишённым некоторых функций по сравнению с оригинальным представлением в BookStack.
- **Простой текстовый файл**  
    Файл .txt, содержащий только текст вашего контента.
- **Файл Markdown**  
    Файл .md, представляющий ваш контент в формате Markdown.  
    Если страница была написана с использованием редактора Markdown, то будет представлен исходный контент. В противном случае система попытается преобразовать контент в Markdown. Получившийся Markdown может всё ещё содержать HTML для некоторых типов контента.
- **Портативный ZIP**  
    Сжатый файл .zip, содержащий данные, файлы вложений и изображения.  
    Этот архив можно повторно импортировать в другие экземпляры BookStack, как упомянуто ниже.  
    Подробное описание формата можно найти в исходниках BookStack.

Кроме перечисленных форматов, в BookStack уделено внимание правильному отображению страниц при печати через браузер. Это позволяет печатать страницы на бумаге или, зачастую, экспортировать в PDF с помощью функции печати браузера.

Для разработчиков многие из этих вариантов экспорта также доступны через REST API BookStack, который предоставляет дополнительные конечные точки, полезные для задач, связанных с экспортом.

#### Импорт

Если у вас есть соответствующее разрешение роли «Импорт контента», вы можете импортировать архивы в формате **«Portable ZIP»** (упоминаемые в разделе экспорта) через действие «Импорт», доступное при просмотре верхнего уровня вида «Книги» или по пути /import вашего экземпляра:

[![import-overview.png](https://bs.kuzstu.ru/uploads/images/gallery/2025-03/scaled-1680-/import-overview.png)](https://bs.kuzstu.ru/uploads/images/gallery/2025-03/import-overview.png)

Здесь вы можете загрузить новый ZIP-файл для импорта или продолжить предыдущий отложенный импорт. Перед началом процесса импорта вам будет предоставлена предварительная версия того, что подлежит импорту. После запуска процесса импортированные данные будут добавлены в BookStack, а исходный загруженный ZIP-файл будет удалён.

Для разработчиков подробности формата ZIP-файла для импорта можно найти здесь, либо рассмотреть использование REST API BookStack для импорта.