black-yt Markdown 转 PDF
使用场景
将 Markdown 文件转为 PDF。脚本会先用 markdown2 转 HTML，再用 WeasyPrint 输出 PDF。
依赖安装
pip install markdown2 weasyprint
WeasyPrint 可能还需要系统图形/字体相关依赖。如果运行时报 Cairo、Pango、fontconfig 等错误，按 WeasyPrint 官方文档补齐系统依赖。
检查：
python -c "import markdown2; from weasyprint import HTML; print('md2pdf deps ok')"
源码追溯
- Markdown 转 HTML 和 HTML 转 PDF 的行为分别由
markdown2和WeasyPrint决定；表格、代码块、图片路径、字体或 CSS 问题不确定时，先查看当前安装版本源码。 module.__file__可定位安装路径。inspect.getsource(...)可查看关键函数或类。- 源码只用于阅读和定位问题，不要改源码，不要直接改
site-packages；优先调整本仓库脚本的参数、CSS 或 wrapper。
python - <<'PY'
import inspect
import markdown2
import weasyprint
from weasyprint import HTML
print("markdown2:", getattr(markdown2, "__version__", "unknown"), markdown2.__file__)
print("weasyprint:", getattr(weasyprint, "__version__", "unknown"), weasyprint.__file__)
print(inspect.getsource(markdown2.markdown))
print(inspect.getsource(HTML.write_pdf))
PY
脚本
优先使用 bundled script：
scripts/md_to_pdf.py
命令行用法
基本用法：
python scripts/md_to_pdf.py input.md output.pdf
指定输出目录：
python scripts/md_to_pdf.py input.md output_dir
指定图片和相对资源的起始路径。第三个参数会作为 WeasyPrint 的 base_url，用于解析 Markdown 中的相对图片路径、CSS 和本地资源：
python scripts/md_to_pdf.py input.md output.pdf /path/to/base_dir
如果 Markdown 中有相对图片路径，例如 ，把第三个参数设为 Markdown 资源所在目录。不要把第三个参数设成某个图片文件本身。
Python 调用
from scripts.md_to_pdf import md_to_pdf
md_to_pdf("input.md", "output.pdf", base_path=".")
功能特性
- 支持普通 Markdown 文本。
- 支持 Markdown 表格：
markdown2的tablesextra。 - 支持 fenced code block：
markdown2的fenced-code-blocksextra。 - 自动注入基础 CSS，使图片最大宽度不超过页面宽度，并给表格加边框和 padding。
- 如果输出路径是目录，会自动使用 Markdown 文件名生成同名
.pdf。
注意事项
- 输入 Markdown 建议使用 UTF-8 编码。
- 图片路径最好使用相对路径，并通过第三个参数传入资源根目录。
- 外部网络图片是否能加载取决于当前网络环境和 WeasyPrint。
- 复杂 HTML、MathJax、LaTeX 公式不一定能被 WeasyPrint 直接渲染。
- 中文字体异常时，需要安装中文字体，并在 CSS 中指定字体。
- 如果需要更复杂的页面尺寸、页边距或字体样式，优先在脚本中的 CSS 块里显式添加规则。
验证
转换后人工打开 PDF，检查中文、图片、表格、代码块换行缩进，以及页面是否有明显溢出、截断或空白。