← 返回 Skills 市场
shanghaiyangming

MD to PDF

作者 shanghaiyangming · GitHub ↗ · v4.0.0 · MIT-0
cross-platform ⚠ pending
76
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install md-to-pdf
功能描述
将 Markdown 文件转换为带封面页的专业 PDF。使用 Pandoc + Chrome Headless 方案,支持中文、表格、emoji、代码高亮、目录。默认自动生成封面(标题+日期),除非指定 --no-cover。
使用说明 (SKILL.md)

MD to PDF v4.0

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

核心流程

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

使用方法

# 带封面 + 目录(默认)
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 白底

依赖

工具 说明
Pandoc 3.6.4 (D:\mycode\pandoc\pandoc.exe)
Chrome 需开启 --remote-debugging-port=9222
Python PyPDF2playwright

故障排除

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 工具发送:

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

⚠️ 旧版 \x3Cqqmedia> 标签已废弃。

版本历史

版本 日期 变更
v4.0 2026-05-16 彻底删除 Pandoc 内置样式,只注入 BUILTIN_CSS;修复封面页 HTTP 服务目录 404
v2.2 2026-05-14 增强 CSS(!important),修复列表/表格渲染
v2.1 2026-05-10 Playwright CDP 替代 Chrome Headless,修复 Chrome 147+ 失效问题
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install md-to-pdf
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /md-to-pdf 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v4.0.0
v4.0: Complete CSS Override strategy, Playwright CDP for Chrome 147+, cover page + TOC support, Chinese/emoji compatible
元数据
Slug md-to-pdf
版本 4.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

MD to PDF 是什么?

将 Markdown 文件转换为带封面页的专业 PDF。使用 Pandoc + Chrome Headless 方案,支持中文、表格、emoji、代码高亮、目录。默认自动生成封面(标题+日期),除非指定 --no-cover。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 76 次。

如何安装 MD to PDF?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install md-to-pdf」即可一键安装,无需额外配置。

MD to PDF 是免费的吗?

是的,MD to PDF 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

MD to PDF 支持哪些平台?

MD to PDF 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 MD to PDF?

由 shanghaiyangming(@shanghaiyangming)开发并维护,当前版本 v4.0.0。

💬 留言讨论