О конвертации md в Word и md в PDF
Зачем вообще конвертировать Markdown
Markdown хорош для написания, но не обязательно для сдачи работы. Когда документ готов, принимающей стороне обычно нужен .docx: чтобы оставить примечания, включить режим рецензирования, залить текст в шаблон организации — или просто потому, что регламент принимает только Word. Еженедельные отчёты, документы с требованиями, тендерные материалы, учебные работы — всё это тот самый случай. Смысл конвертации не в смене расширения, а в том, чтобы превратить текстовую разметку в стили, понятные Word: заголовки становятся уровнями структуры, по которым собирается оглавление, списки — настоящими нумерованными списками, а таблицы — объектами-таблицами, у которых можно тянуть ширину столбцов.
Word или PDF?
Если текст ещё будет меняться, кто-то должен его прокомментировать или он идёт по циклу согласования — конвертируйте в Word. Если версия окончательная и её пора отправлять, печатать или сдавать в архив — конвертируйте в PDF: вёрстка сохраняется на разных компьютерах, строки не съезжают из-за отсутствующего у получателя шрифта, и случайно изменить содержимое сложнее. На практике часто поступают так: сначала экспортируют Word и проходят согласование, а в конце выгружают PDF как замороженную версию. Эта страница умеет и то и другое — просто сконвертируйте один и тот же Markdown дважды.
Онлайн-конвертация или Pandoc
Pandoc — стандартный ответ для такой конвертации: шаблоны, эталонные стили, перекрёстные ссылки и библиография полностью под вашим контролем, что делает его правильным выбором для документационного конвейера, который живёт годами. Плата за это — установка, настройка окружения LaTeX и необходимость помнить параметры. Если же нужно сдать один-единственный файл, разворачивать ради этого окружение невыгодно: эта страница конвертирует прямо в браузере, без установки и без регистрации, и файл не покидает ваш компьютер. А когда действительно понадобится долгосрочная автоматизация, Pandoc никуда не денется.
Какие конструкции конвертируются хуже всего
У сырого HTML, вписанного прямо в Markdown, глубоко вложенных таблиц и пользовательского CSS нет соответствующих структур в Word и PDF, поэтому при конвертации они упрощаются. Расширенный синтаксис, завязанный на конкретный отрисовщик — математические формулы, диаграммы Mermaid, — выйдет не таким, каким выглядит на исходной платформе. Картинки, указанные путями на локальном диске, тоже не подтянутся: браузер не может читать другие файлы из той же папки — замените их ссылками на изображения в сети. Перед конвертацией загляните в предпросмотр: то, что вы там видите, близко к тому, что получится при экспорте.