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

Markdown — простой текст с пометками: решётки в начале строки делают её заголовком, звёздочки вокруг слова — выделением, вертикальные черты — таблицей. Так пишут README на GitHub, заметки в Obsidian, документацию в редакторах кода, так же размечают ответы многие чат-боты с нейросетью. Но начальник, преподаватель или заказчик ждёт обычный документ Word. Конвертер md в docx делает из разметки нормальный .docx: заголовки остаются заголовками, таблицы становятся таблицами с сеткой, сноски — настоящими сносками Word.

Читается markdown в стиле GitHub: жирный, курсив, зачёркнутый, код в строке и блоки кода, цитаты (в том числе вложенные), списки — даже без пустой строки перед ними, — списки задач с отметками ☒ и ☐, ссылки и «голые» адреса. Шапка YAML с полями title, author и date превращается в абзацы «Название», «Автор» и «Дата» в начале документа и в свойство «Заголовок» самого файла. Текст набирается шрифтом Calibri, заголовки — Calibri Light, лист — A4.

Первый случай — сдать работу по правилам офиса. Разработчик описал сервис в README, аналитик собрал требования в Obsidian, студент вёл конспект в Typora, а принимают отчёт, ТЗ или курсовую только файлом .docx, в который можно вписать замечания в режиме рецензирования. Переписывать руками долго и рискованно: съезжают таблицы, теряются сноски. Конвертация переносит структуру за один раз, а дальше документ живёт по законам Word.

Второй случай — ответ нейросети. Чат-боты часто присылают ответ разметкой: заголовки с решётками, списки, таблицы из вертикальных черт. Если сохранить такой ответ в файл .md и перевести в docx, получится аккуратный документ, в котором таблица — это таблица Word, а не столбики из символов. Кавычки при этом остаются такими, как набраны: прямые не превращаются в английские.

Третий случай — печать и отправка людям, далёким от разработки. Markdown в сыром виде выглядит для них набором значков, а .docx открывается в Word, LibreOffice и Google Docs. Отметки списков задач сохраняются значками ☒ и ☐, а плашки GitHub вида NOTE или WARNING получают русские заголовки «Примечание», «Совет», «Важно», «Внимание», «Осторожно» — читателю не придётся гадать, что значит английское слово в квадратных скобках.

Картинки. В документ попадают картинки, встроенные в сам markdown как data-адрес (data:image). Картинки по адресу в интернете и по пути к файлу на диске сервер не скачивает — на их месте остаётся подпись. Если иллюстрации важны, вставьте их в Word после конвертации или заранее встройте в .md.

Размер и время. Предел — 3 МБ: markdown больше этого сервер не потянет по памяти. Заметка на 2,7 КБ обрабатывается на нашем сервере за 0,36 секунды и превращается в .docx на 15 КБ. Файл на 2,9 МБ с 797 таблицами и 1594 сносками занял 27,6–29,9 секунды, так что даже тяжёлый случай укладывается в срок одной конвертации — 120 секунд. Трёхмегабайтный markdown даёт документ примерно на 370 КБ.

Кодировки и переводы строк. Файл в UTF-8 (с BOM и без), UTF-16, Windows-1251, KOI8-R или CP866 читается без «кракозябр», а переводы строк Windows и Unix дают одинаковый результат. UTF-32 не поддерживается — такой файл нужно пересохранить в UTF-8. Язык документа выбирается по тексту: если кириллицы меньше четверти букв, документ помечается английским, а строка lang в шапке YAML главнее этого выбора.