Markdown в PDF с таблицами, кодом и формулами

Техническая документация редко обходится без таблиц параметров, листингов и формул. На конвертере Markdown → PDF все эти элементы попадают в печатный макет из того же HTML-предпросмотра, что вы видите на экране. PDF сохраняется через диалог браузера «Сохранить как PDF» — автоматической загрузки без подтверждения нет.

Пример документа

# Спецификация API v2

## Коды ответов

| HTTP | Значение | Описание |
|------|:--------:|----------|
| 200 | OK | Успешный запрос |
| 404 | Not Found | Ресурс не найден |
| 500 | Error | Внутренняя ошибка |

## Пример запроса

```bash
curl -H "Authorization: Bearer TOKEN" \
  https://api.example.com/v2/items
```

## Формула лимита

Скользящее окно: $W = \sum_{i=1}^{n} w_i \cdot \mathbb{1}_{t - t_i < \Delta}$

## Диаграмма (Mermaid)

```mermaid
flowchart LR
  Client --> API
  API --> DB[(PostgreSQL)]
```

## Примечание

Текст **жирный** и `inline code` сохраняются в PDF как векторный текст.

Что ожидать в PDF

Таблица с границами и выравниванием колонки «Значение».
Блок bash с переносом длинных строк.
Формула KaTeX — как в preview (не LaTeX для редактирования).
Mermaid — SVG в печатном HTML.
Кликабельные ссылки, если браузер сохраняет их при «Save as PDF».

Точные поля и разрывы страниц зависят от Chrome, Firefox или Safari — проверьте файл у себя.

Пошагово

Откройте Markdown → PDF.
Вставьте MD или загрузите файл; дождитесь Mermaid («Строим диаграмму…»).
Нажмите «Печать / PDF».
В диалоге:
- Принтер: Save as PDF / «Microsoft Print to PDF».
- Отключите колонтитулы (URL и дата сверху/снизу).
- Включите «Фоновая графика», если нужен серый фон у code blocks.
Сохраните файл.

Подробнее о таблицах — в гайде по таблицам Markdown, о Mermaid — в отдельной статье.

PDF vs Word vs HTML

Задача	Инструмент
Печать и архив	PDF
Редактирование в Word	DOCX
Вставка на сайт	HTML

PDF здесь — не серверный wkhtmltopdf, а нативная печать браузера. Это плюс для приватности (текст не уходит на сервер) и минус для полного контроля макета.

Ограничения

Нет кнопки «скачать PDF» без диалога — только print → Save as PDF.
Очень широкие таблицы могут сжиматься или переноситься неудобно.
Фон code blocks без «Background graphics» может не напечататься.
Формат бумаги по умолчанию в CSS — A4; Letter — через настройки печати ОС.

Итог

Markdown с таблицами, кодом и формулами переводится в PDF так: рендер в браузере → предпросмотр → печать → «Сохранить как PDF». Бесплатно, без регистрации, локально на вашем устройстве.

Как перевести Markdown в PDF с таблицами, кодом и формулами