Документ в формате Markdown (.md) или Word (.docx) можно импортировать в базу знаний Stormbpmn: каждый файл становится отдельной страницей. Обратно любую страницу можно выгрузить в файл Markdown.
Импорт файлов
Импортировать можно сразу в корень раздела «Статьи» или подстраницей к уже существующей странице.
Чтобы импортировать файлы в корень, открыть раздел «Знания» в меню приложения и в строке «Статьи» нажать кнопку «Импортировать файлы» (значок со стрелкой вверх). Откроется окно выбора файлов.

Чтобы импортировать подстраницу, навести курсор на нужную страницу в дереве, нажать меню «⋮» и выбрать «Импортировать подстраницу (MD, DOCX)». Подстраницу можно добавить только к опубликованной странице.

Дальше выбрать один или несколько файлов на компьютере. Отдельного окна с настройками нет: импорт начинается сразу после выбора.
Заголовок новой страницы берётся из первого заголовка верхнего уровня в документе, а если его нет — из имени файла. Импортированная страница сразу публикуется.
Один файл
Если выбран один файл, после импорта сразу открывается новая страница, и появляется сообщение «Импортировано блоков: N».
Несколько файлов
Можно выбрать до 200 файлов за раз. Откроется окно «Импорт файлов» с ходом загрузки. Когда импорт закончится, в окне появится список созданных страниц, а также файлы, которые импортировать не удалось, с причиной. По ссылке в списке можно сразу перейти на страницу. Закрыть окно — кнопкой «Готово».
Окно можно закрыть и до окончания импорта: он продолжится на сервере, даже если закрыть вкладку. Чтобы вернуться к окну, нажать кнопку импорта ещё раз.

Форматы и ограничения
Поддерживаемые форматы: .md, .markdown, .docx, .docm. Файлы .doc и .rtf не поддерживаются — документ нужно сохранить в формате .docx и повторить импорт.
-
Markdown-файл — до 2 МБ.
-
Файл Word (.docx) — до 30 МБ.
-
В документе — не более 5 000 блоков.
-
Импортировать могут участники с правом создавать и редактировать страницы базы знаний.
Что переносится из Word (.docx)
При импорте из Word переносятся: заголовки, абзацы, жирный, курсив, подчёркивание, зачёркивание, выделение, ссылки, списки с вложенностью, таблицы (включая объединённые ячейки), картинки и сноски.
При импорте из Markdown поддерживаются таблицы (в форматах GFM и HTML) и изображения. Для переноса строки в ячейке таблицы использовать тег <br>. Изображения вставляются по ссылке или как файл, загруженный в систему.
Что не переносится из Word
Следующие элементы не переносятся, и после импорта появляется окно «Импортировано с ограничениями» со списком того, что пропущено:
-
автооглавление,
-
колонтитулы,
-
надписи, фигуры и SmartArt,
-
внедрённые объекты,
-
формулы.
Вложенные таблицы разворачиваются в обычный текст.
Экспорт страницы в Markdown
Экспорт создаёт файл Markdown с содержимым того, что открыто на экране, — черновика или опубликованной версии. Вставки других страниц разворачиваются в текст.
-
Открыть нужную страницу в базе знаний.
-
Если страница в режиме правки, дождаться, пока в шапке появится «Сохранено».
-
Нажать меню «⋮» в шапке страницы.
-
Выбрать пункт «Экспорт в MD».
Файл с расширением .md сохранится на компьютер. Его можно открыть в любом текстовом редакторе или импортировать обратно в базу знаний.

При экспорте таблицы сохраняются в формате GFM (для простых таблиц) или HTML (если в таблице есть объединённые ячейки, цвет или размер). Изображения сохраняются как ссылки в формате Markdown. Для переноса строки внутри ячейки таблицы используется тег <br>.
Частые вопросы
Вопрос: Где выбрать заголовок новой страницы при импорте?
Ответ: Отдельного поля нет. Заголовком становится первый заголовок верхнего уровня в документе, а если его нет — имя файла. После импорта страницу можно переименовать.
Вопрос: Не появляется пункт «Импортировать подстраницу». Почему?
Ответ: Импорт доступен участникам с правом создавать и редактировать страницы. Кроме того, подстраницу нельзя импортировать к черновику, который ещё ни разу не публиковался, и в раздел «Переиспользуемые».
Вопрос: Как импортировать файл .doc или .rtf?
Ответ: Открыть файл в Word, сохранить его в формате .docx и импортировать заново.
Вопрос: Можно ли импортировать сразу папку документов?
Ответ: Можно выбрать сразу несколько файлов — до 200 за раз. Все они станут страницами одного уровня: в корне или подстраницами выбранной страницы.
Частые формулировки
«импорт из Word», «выгрузить в markdown», «импорт md», «экспорт страницы», «перенести документ», «загрузить docx в базу знаний», «скачать страницу в md», «импорт markdown файла», «экспорт вики в markdown», «таблицы в markdown импорте», «картинки в markdown экспорте», «как сохранить таблицу в md», «перенос строки в ячейке таблицы markdown», «импорт нескольких файлов», «массовый импорт документов», «загрузить документы в базу знаний».