md-pdf

# md-pdf Конвертация markdown -> PDF без зависимостей: md -> HTML (мини-конвертер и дефолтные стили внутри скрипта) -> печать установленным Chrome в headless-режиме. Скрипт-эталон - `scripts/md-pdf.py` (top-level папка `scripts/` в корне проекта). Не нужны pandoc/LaTeX/weasyprint - только Chrome. ## Когда применять - Нужно отдать md-контент наружу файлом: отчет заказчику, саммари встречи, КП, конспект на печать. - Проектный документ регулярно пересобирается в PDF (см. "Специализация"). ## Когда НЕ применять - Получателю подойдет сам markdown или текст в чате - PDF ради PDF не делать. - Документ со сложной версткой (многоколоночность, вложенные списки) - конвертер их не умеет; либо дорабатывать конвертер, либо собирать HTML вручную и печатать тем же Chrome. Простые GFM-таблицы (однострочные ячейки) он умеет. ## CLI ```bash python3 scripts/md-pdf.py note.md # note.pdf рядом с исходником python3 scripts/md-pdf.py note.md --out /path/x.pdf # свой путь python3 scripts/md-pdf.py note.md --css custom.css --title "Отчет" python3 scripts/md-pdf.py note.md --author "Имя" # /Author в метаданные PDF ``` Chrome ищется по стандартному пути macOS; иной путь - через переменную окружения `MD_PDF_CHROME`. ## Грабли (проверено практикой) - **Текст в Chrome-PDF не грепается** (глифовые индексы, не юникод). Верифицировать содержимое по сгенерированному HTML (функция `md_to_html`), а не по PDF; глазами PDF смотрит пользователь. Для таблиц - считать `<table>`/`<tr>...