Конвертер Word в Markdown

Этот инструмент превращает документ Word (.docx) в Markdown — текст с лёгкой разметкой, который понимают GitHub и GitLab, Obsidian, генераторы сайтов документации и многие вики. Docx в md нужен, когда документ пора перенести из офиса туда, где тексты хранят рядом с кодом, сравнивают по версиям и правят в любом редакторе. Разметка получается в стиле GitHub, и абзацы не рвутся переводами строк посреди предложения: каждый абзац — одна строка, поэтому в истории изменений видно, какой именно абзац поправили.

Что получится на выходе, зависит от картинок. Если в документе их нет, скачивается один файл .md в кодировке UTF-8. Если есть — архив ZIP: внутри файл .md с тем же именем, что у документа («Отчёт (итог).docx» → «Отчёт (итог).md»), и папка media с картинками, на которые разметка ссылается относительными путями вида ./media/…. Распаковали архив в репозиторий — и картинки показываются на своих местах.

Документация рядом с кодом. Регламенты, инструкции по развёртыванию, описания API часто рождаются в Word у аналитика или руководителя, а жить должны в репозитории: в README, в папке docs, на сайте документации. Перевод docx в markdown переносит структуру целиком — заголовки, списки, таблицы, ссылки, — и дальше текст правится как код: через запросы на слияние, с историей и ревью.

База знаний в Obsidian. Заметки в нём — обычные файлы .md в папке на диске. Старые конспекты, статьи и протоколы из Word после конвертации становятся полноценными заметками: заголовки делят текст на разделы, сноски остаются сносками, а картинки лежат в соседней папке media.

Тексты для сайтов и нейросетей. Генераторы статических сайтов — Hugo, Jekyll, MkDocs, Docusaurus — собирают страницы из markdown, и статью из Word достаточно один раз перевести, чтобы дальше вести её в репозитории сайта. А при загрузке документа в чат-бот с нейросетью markdown удобен тем, что разметка заголовков и списков видна прямо в тексте, без форматирования Word.

Название и подзаголовок документа попадают в начало файла — заголовком и абзацем. Дальше идут заголовки разделов, выделения (зачёркнутый текст — двумя тильдами, подчёркнутый — HTML-тегом u, потому что в markdown своей пометки для подчёркивания нет), вложенные списки, ссылки и подписи рисунков. Сноски оформляются сносками markdown с номерами, а из автоматического оглавления получается перечень ссылок на заголовки: на GitHub по ним можно переходить, номеров страниц там нет.

Таблицы. Markdown умеет только простые таблицы, поэтому конвертер поступает так: таблица без объединённых ячеек становится таблицей markdown (в нашем тестовом документе на 154 страницы — 20 из 20), а таблица с объединёнными ячейками записывается HTML-таблицей прямо внутри .md, чтобы не потерять структуру. GitHub показывает и те, и другие.

Теряется оформление, для которого в markdown нет места: колонтитулы, заливка ячеек, шрифты и цвета. Работает это быстро: документ в пять страниц сервер разбирает за 0,3–0,4 секунды, а 154 страницы с 44 фотографиями — за 4,9 секунды. Архив отчёта с одной картинкой весит 15 КБ, архив большого документа — 5,36 МБ: 42 файла картинок и 44 ссылки на них.