Как конвертировать Markdown в PDF (бесплатно, с кодом и таблицами)

Markdown — то, в чём пишут: README, заметки со встреч, спеки, документацию. PDF — то, что отправляют: клиенту, который не откроет .md, руководителю, которому нужно вложение, на принтер. Между ними — одна конвертация, и ради неё не должно требоваться ставить pandoc и дистрибутив LaTeX.

Подвох большинства быстрых путей в том, что они калечат ровно те части, на которых держатся технические документы: блоки кода схлопываются в пропорциональный шрифт, pipe-таблицы печатаются стеной символов |, вложенные списки расплющиваются. Конвертер здесь полезен, только если код и таблицы выживают — по этой планке это руководство и меряет всё.

Как конвертировать — пошагово

🔒 pdfty.com/en/tools/markdown-to-pdf

Что именно отрисовывается

Конвертер поддерживает стандартный Markdown плюс расширения, важные для технических текстов:

• Заголовки — размерная иерархия, с тонкими линейками под H1 и H2
• Fenced-блоки кода — моноширинный шрифт, светло-серый фон, сохранённые отступы, подсветка синтаксиса для распространённых языков
• Инлайновый код — знакомое оформление серой «плашкой»
• Таблицы — pipe-таблицы в стиле GitHub становятся таблицами с рамками и затенённой строкой заголовка
• Цитаты — левая граница, приглушённый текст
• Списки — нумерованные, маркированные, вложенные
• Ссылки — остаются кликабельными ссылками в PDF
• Картинки по URL — изображения ![](https://…) скачиваются и встраиваются

Страница верстается на комфортной для чтения ширине с щедрыми полями — ближе к «внутренний документ, который выглядит законченным», чем к сырому отпечатку из браузера.

Что НЕ отрисовывается

Секция честности. У Markdown есть диалекты, и этот инструмент реализует стандартный Markdown + таблицы + fenced-код, а не весь GitHub-вкус:

• Чекбоксы задач (- [ ] todo) печатаются буквальными скобками, а не галочками.
• Зачёркивание (~~текст~~) не конвертируется — тильды остаются.
• Локальные картинки (![](./diagrams/arch.png)) появиться не могут: вы загружаете один файл, и у сервера нет доступа к файлам рядом с ним на вашем диске. Разместите картинку по URL или ждите пробела.
• Блоки Mermaid и математика отрисовываются обычными блоками кода, а не диаграммами и формулами.
• Своих тем нет — один встроенный стиль, без загрузки CSS.

Бесплатные локальные альтернативы

pandoc — канонический конвертер: pandoc README.md -o readme.pdf. Великолепный результат и бесконечная настраиваемость, но PDF-вывод требует движка LaTeX (часто установка на 1–4 ГБ). Оправданно, если конвертируете документы еженедельно; абсурдно ради одного README.

Расширения VS Code (например, «Markdown PDF») — удобно, если вы и так живёте в VS Code; качество вывода зависит от расширения и темы.

Предпросмотр в браузере + печать: отрисуйте Markdown там, где он показывается (многие редакторы умеют HTML-превью), затем Ctrl/Cmd+P → Сохранить как PDF. Бесплатно и локально, но вы наследуете причуды браузерной печати: URL в колонтитулах, пока не отключите, и разрывы страниц посреди блока кода.

macOS: встроенного рендера Markdown нет — Preview и TextEdit считают .md простым текстом, так что вы увидите голые решётки и звёздочки.

Практические подводные камни

• Разрывы страниц автоматические. Длинные блоки кода могут разъехаться на две страницы. Маркера ручного разрыва нет; движок рвёт там, где нужно.
• Очень широкие таблицы и длинные строки кода масштабируются или обрезаются по ширине содержимого — строка таблицы на 200 символов не уляжется изящно на портретную страницу. Где можете — укорачивайте.
• Front matter (--- YAML в начале файла) считается содержимым, а не скрывается — удалите его до конвертации, если не хотите видеть в печати. (Блок --- в самом верху может также отрисоваться как горизонтальная линия плюс текст, в зависимости от форматирования.)
• Шорткоды эмодзи вроде :rocket: остаются буквальными; настоящие вставленные символы эмодзи обычно отрисовываются.
• Проверяйте адреса ссылок. Относительные ссылки ([docs](./docs/setup.md)) выживают как ссылки, но после печати никуда не ведут.

Когда PDF готов, работает привычный набор: проштампуйте его Колонтитулами со счётчиками страниц, соберите главы через Объединить или ужмите тяжёлый от картинок файл через Сжать PDF.

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

Блоки кода сохранят подсветку синтаксиса?

Да — fenced-блоки с подсказкой языка (```python) получают цветную подсветку; без подсказки — обычный моноширинный шрифт на сером. В любом случае отступы сохраняются точно.

Таблицы правда отрисуются таблицами?

Да — pipe-таблицы (стиль GitHub) становятся таблицами с рамками и затенённой строкой заголовка. Двоеточия выравнивания парсер уважает.

Почему в PDF нет моей картинки?

Она указана локальным путём. Загружается один .md-файл, так что ./images/x.png ни на что не указывает. Используйте полный https://-URL или конвертируйте локально через pandoc, где относительные пути разрешаются.

Можно сконвертировать README прямо с GitHub?

Сначала скачайте сырой .md-файл, затем загрузите его. Бейджи и картинки с полными URL обычно доезжают; фишки только для GitHub (чекбоксы задач, mermaid) — нет, смотрите список выше.

Можно поменять шрифты, поля или цвета?

В этом инструменте нет — он поставляется с одним намеренно чистым стилем. Для брендированного дизайна идите через HTML в PDF со своим CSS.

Есть лимит размера или страниц?

Бесплатно: 20 МБ на файл и 10 операций в день — для текстовых файлов это фактически без лимита. PDF длиннее 50 страниц из одного Markdown-источника генерируются нормально.

Мой документ приватен?

Передача по HTTPS, файлы автоматически удаляются в течение 1 часа. Для конфиденциального, что загружать нельзя, локальный путь — pandoc.

Можно в обратную сторону — PDF в Markdown?

Напрямую нет. Ближайшее — Извлечь текст (простой текст без форматирования) или PDF в Word с последующей доводкой.