MD to PDF v4.0#

将 Markdown 转换为带封面页的高质量 PDF。

核心流程#

text

MD 文件 → [提取标题] → 生成封面 HTML
                      → Pandoc 生成正文 HTML
                      → 本地 HTTP 服务 (127.0.0.1:PORT)
                      → Playwright CDP (chrome port 9222)
                      → page.pdf() 导出封面/正文 PDF
                      → PyPDF2 合并 → 最终 PDF

使用方法#

bash

# 带封面 + 目录（默认）
python "C:\Users\ThinkPad\.openclaw\workspace\skills\md-to-pdf\md_to_pdf_v4.py" input.md output.pdf --toc

# 不要封面页
python "C:\Users\ThinkPad\.openclaw\workspace\skills\md-to-pdf\md_to_pdf_v4.py" input.md output.pdf --toc --no-cover

# 自定义 CSS
python "C:\Users\ThinkPad\.openclaw\workspace\skills\md-to-pdf\md_to_pdf_v4.py" input.md output.pdf --toc --css custom.css

封面页#

默认自动生成：

• 标题：从 MD 文件第一个 # 标题 提取
• 日期：当前日期（如 2026年05月16日）
• 样式：居中大标题 + 底部日期横线，A4 白底

依赖#

工具说明Pandoc3.6.4 ( D:\mycode\pandoc\pandoc.exe)Chrome需开启 --remote-debugging-port=9222PythonPyPDF2、 playwright

故障排除#

Chrome 147+ --print-to-pdf 失效（已修复）#

Chrome v147+ 命令行 --headless --print-to-pdf 在 Windows 上已失效。

修复：改用 Playwright CDP page.pdf() + 本地 HTTP 服务（ http.server）提供 HTML 文件。

列表符号不显示（已修复）#

Chrome Headless 默认不渲染列表符号。

修复：CSS 显式声明 list-style-type（已内置）。

发送 PDF（QQ Bot）#

必须用 Copy-Item 复制到媒体目录，再用 message 工具发送：

powershell

Copy-Item $pdfPath "C:\Users\ThinkPad\.openclaw\media\qqbot\文件名.pdf" -Force

text

message(action="send", channel="qqbot", filePath="C:\Users\ThinkPad\.openclaw\media\qqbot\文件名.pdf", target="...")

⚠️ 旧版 <qqmedia> 标签已废弃。

版本历史#

版本日期变更v4.02026-05-16彻底删除 Pandoc 内置样式，只注入 BUILTIN_CSS；修复封面页 HTTP 服务目录 404v2.22026-05-14增强 CSS（ !important），修复列表/表格渲染v2.12026-05-10Playwright CDP 替代 Chrome Headless，修复 Chrome 147+ 失效问题