Markdown → PDF (Playwright)

Hi，你好，我是Carl，一个本科进大厂做了2年+AI研发后，裸辞的AI创业者。

这个工具用于把 Markdown（.md）转换成高质量 PDF（.pdf）。

实现方式：用 markdown 将 Markdown 转成 HTML，并用 Playwright（Chromium）渲染页面后“打印”为 PDF。内置一份简化的 GitHub 风格 CSS，默认支持表格、代码块、目录（TOC）等常见特性。

特性

• 批量转换：递归扫描当前目录下所有 .md
• 单文件转换：指定输入/输出路径
• 浏览器渲染：样式稳定、所见即所得

环境要求

• Python 3.8+
• macOS / Linux / Windows

安装

1. 安装 Python 依赖

pip install -r requirements.txt

（可选）国内源：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

2. 安装 Playwright 浏览器内核（Chromium）

python3 -m playwright install chromium

在 Linux 上如遇依赖缺失，可再运行：

python3 -m playwright install-deps chromium

使用

批量转换（默认：在当前目录递归转换所有 .md）：

python3 convert_md_to_pdf_playwright.py

单文件转换：

python3 convert_md_to_pdf_playwright.py -i input.md -o output.pdf

查看帮助：

python3 convert_md_to_pdf_playwright.py -h

说明与限制

• 相对路径图片：脚本会把临时 HTML 写在 Markdown 同目录下（*.temp.html），因此 ![](./img.png) 这类相对路径通常能正常解析。
• PDF 默认参数：A4、打印背景、页边距 2cm。
• 清理：正常情况下会自动删除 *.temp.html；如果转换中断导致残留，可手动删除。