Notion и Markdown: как перенести документы и не потерять форматирование

Notion удобен для совместных страниц, Markdown — для Git, статических сайтов документации и ассистентов, которые едят обычный текст. Перенос ломается не на «кнопке экспорта», а на блоках: колонки, базы данных, упоминания, вложенные страницы. Часть структуры уходит в HTML или в архив ZIP, часть превращается в плоский текст. Задача статьи — сохранить заголовки, списки и ссылки так, чтобы глава жила в .md без ручной перекладки каждого абзаца. Сравнение форматов документации: Markdown vs Word vs Google Docs. Как вести docs дальше: документация в Markdown. Чем открыть результат: чем открыть MD-файл. Доводка на Тулси: конвертер в Markdown. Ниже: экспорт из Notion, что сохраняется, что править руками и как проверить файл перед коммитом.

Зачем вытаскивать страницы из Notion в Markdown

В Notion хорошо писать вместе и держать базу рядом с задачами. В репозитории и в MkDocs канон удобнее как набор .md: дифф по строкам, сборка сайта, поиск по файлам без API Notion.

Ассистенты и поисковые индексы проще кормить текстом с # и списками, чем деревом блоков облачного редактора. Выгрузка в Markdown — мост: смысл глав остаётся, привязка к одному вендору слабеет.

Типичный путь: команда накопила инструкции в Notion, решила вести docs в Git. Нужен честный экспорт и чистка, а не «скопировать всё в одну простыню».

Когда Notion оставляют каноном

Если правит в основном нетехническая команда и репозитория нет, Notion может остаться источником. Тогда Markdown — снимок для бэкапа или для ассистента, а не место ежедневной правки.

Если же релизы идут из Git, канон перенесите в .md. Иначе через полгода снова склеиваете две правды. Расклад ролей форматов: Markdown vs Word vs Google Docs.

Что обычно теряется при переносе

Колонки становятся последовательными блоками. Вкладки и синхронизированные блоки разворачиваются неочевидно. Базы данных уходят в CSV или в урезанную таблицу. Цвета, обложки и иконки для .md не нужны — их ожидать не стоит.

Упоминания людей и страниц иногда превращаются в голый текст или в длинный URL. Проверьте оглавление и перекрёстные ссылки после экспорта.

Как экспортировать и подготовить файлы

В Notion откройте страницу или раздел. Экспорт: Markdown & CSV или HTML — смотря что доступно на вашем тарифе и что лучше переносит структуру. Для дерева страниц часто удобен ZIP с набором файлов.

Распакуйте архив. Найдите главные .md и папки вложений. Переименуйте файлы латиницей без пробелов, если дальше ждут Git и сборщик. Картинки положите рядом по правилам вашей docs/.

Если на выходе больше HTML, чем Markdown, прогоните файл через конвертер в Markdown или узкий путь HTML → Markdown на сайте. Цель — читаемые заголовки #, ## и списки.

Импорт Markdown обратно в Notion

Notion умеет импортировать .md. Заголовки и списки обычно встают. Сложные таблицы и якоря проверьте глазами. После импорта не считайте структуру «один в один» с Git: Notion снова станет своим деревом блоков.

Если канон в Git, импорт — для чтения гуманитарной командой, а не для обратной перезаписи репозитория без правил. Иначе снова получите две ветки правды.

Базы данных и вложения

Таблицы-базы выгрузите отдельно как CSV, если строки важны как данные. В Markdown оставляйте краткую витрину или ссылку на CSV в docs/. Тяжелые вложения храните в assets/ и ссылайтесь относительно.

Секреты и персональные данные из внутренних wiki перед выгрузкой вырежьте. Экспорт не заменяет политику доступа.

Как проверить, что форматирование на месте

Откройте .md в редакторе с превью или посмотрите через чем открыть MD-файл. Сверьте оглавление: каждый бывший блок Heading должен стать заголовком нужного уровня.

Пройдитесь по спискам и чекбоксам. Вложенность должна читаться отступами. Ссылки откройте выборочно: внутренние пути Notion часто нужно заменить на относительные ссылки между главами.

Соберите превью документации, если уже есть MkDocs или аналог. Практика ведения: документация в Markdown. Одна глава-пилот лучше, чем перенос всего пространства за вечер.

Ручная доводка, которую нельзя пропустить

Замените «мусорные» HTML-обрывки на чистый Markdown. Выровняйте уровни заголовков: один h1 на главу. Вынесите длинные цитаты и код в блоки с ограждениями.

Таблицы проверьте на разъехавшиеся колонки. Если таблица критична, иногда честнее держать исходник в CSV и генерировать фрагмент, чем чинить кривую сетку руками каждый раз.

Мини-чеклист перед коммитом

Имена файлов стабильны. Картинки на месте. Нет внутренних URL Notion в проде. Оглавление сходится с заголовками. Секреты вычищены. После этого открывайте pull request.

Если файл ещё в DOC/HTML/PDF, сначала конвертер в Markdown, затем та же проверка заголовков и ссылок.

Смежные статьи и инструмент

Выбор среды: Markdown vs Word vs Google Docs. Жизнь docs в Git: документация в Markdown. Просмотр .md: чем открыть MD-файл. Доводка: конвертер в Markdown.

Перенос из Notion — частный случай общей задачи «сделать текст каноном вне облачного редактора». Держите одну правду в выбранном месте.

Частые вопросы

Можно ли перенести целое пространство Notion одной кнопкой?

Крупный экспорт даёт ZIP с множеством страниц, но чистка всё равно ручная. Колонки, базы и ссылки требуют прохода. Начните с одного раздела-пилота. Массовый перенос без проверки ломает оглавление и якоря.

Что лучше экспортировать: Markdown или HTML?

Если Notion сразу даёт приемлемый .md — берите его. Если структура в HTML живее, конвертируйте через конвертер в Markdown или HTML-путь на сайте. Сравните один и тот же раздел обоими способами на пилоте. Оставьте тот вариант, где заголовки ровнее.

Сохраняются ли базы данных как таблицы Markdown?

Часто нет в полном виде: удобнее CSV рядом с главой. В .md оставьте краткую таблицу или описание схемы. Для документации продукта важнее смысл полей, чем все строки выгрузки. Не обещайте «полная копия базы в Markdown».

Как не потерять картинки?

В ZIP они лежат отдельными файлами. Перенесите их в docs/assets/ и поправьте пути в .md на относительные. Проверьте превью. Битые ссылки на CDN Notion в репозитории не нужны.

Нужно ли оставлять Notion после переноса в Git?

Только как зеркало для чтения, если команда так договорилась. Канон должен быть один. Иначе правки снова разъедутся. Роли форматов разобраны в Markdown vs Word vs Google Docs.

Чем открыть полученный .md на Windows?

Блокнот покажет сырой текст, VS Code или другой редактор с превью — читаемый вид. Подробности: чем открыть MD-файл. Для гостя без редактора соберите HTML или PDF из Markdown отдельным шагом.

Почему после импорта в Notion съехали заголовки?

Notion по-своему трактует уровни и блоки. Импорт — не гарантия зеркала. Выровняйте заголовки в .md до одного h1 на страницу и простых h2/h3. Снова импортируйте пилот и сравните.

Что делать с синхронизированными блоками?

При экспорте они часто разворачиваются в обычный текст или дублируются. Зафиксируйте, какой фрагмент канонический. В Git держите одну копию и ссылки между главами. Не плодите три одинаковых абзаца «на всякий случай».

Как встроить выгрузку в уже существующую docs/?

Скопируйте пилотные главы в структуру из документация в Markdown. Подключите пункты в меню сборщика. Прогоните сборку. Только потом переносите остальные разделы пакетами.

Где довести файл до чистого Markdown на Тулси?

Откройте конвертер в Markdown и загрузите подходящий исходник. Сверьте заголовки с соседними материалами выше. Затем положите .md в репозиторий и откройте превью локально.

Экспортируйте пилотный раздел из Notion, доведите файл через конвертер в Markdown при необходимости и проверьте заголовки. Дальше по стеку: документация в Markdown, чем открыть MD-файл, выбор среды — Markdown vs Word vs Google Docs.