Markdown 到精美 PDF:3 条 Claude Skill 路径(含中文字体)
用 Claude Code 把 Markdown 变成印刷级 PDF 的三条路径横评。版式质量、中文字体处理、后处理灵活性对比,附安装命令和流水线示例。
把 Markdown 转成 .pdf 听起来简单,直到你发现三个问题:中文字体显示成方块、
分页正好切断段落中间、内嵌代码块的语法高亮丢了。多数 pandoc 一行命令至少
踩中其中一个。Claude skill 生态有三条路径各自解决一部分。
这篇横评对比它们,告诉你什么场景选哪条。
路径 1:pdf-creator(WeasyPrint,懂中文)
pdf-creator 来自 @daymade,
是三者里最”前端”的——用 WeasyPrint,HTML/CSS 转 PDF。
CSS 引擎处理中文字体、版式、分页都比 pandoc 的 LaTeX 路径好。
npx degit daymade/claude-code-skills/pdf-creator ~/.claude/skills/pdf-creator
什么时候用:
- 源文件是中英混排 + 代码块的 Markdown。
- 想要正确的中文字体渲染,不用手动配置字体 fallback 链。
- 需要现代 CSS 打印特性(page-break-after、命名页、running headers)。
流水线示例:
用 pdf-creator 把这份研究笔记(中文正文 + 英文代码块)渲染成印刷级 A4 PDF。 正文用衬线字体,确保中日韩字符正常显示。保存到
./output/notes.pdf。
路径 2:anthropic-pdf(处理已有 PDF,不是生成)
anthropic-pdf 是路径 1 的反向——它处理已经存在的
PDF,而不是从 Markdown 生成新的。
npx degit anthropics/skills/skills/pdf ~/.claude/skills/pdf
什么时候用:
- 你已经有 PDF,要合并 / 拆分 / 加水印 / OCR / 加密。
- 在做一个消费 PDF 的流水线(抽表格、抽文本、填表单字段)。
- 需要 PDF 往返(读 → 改 → 写)。
它不是 Markdown → PDF 工具。但接在 pdf-creator 之后,它是后处理器: pdf-creator 生成、anthropic-pdf 加水印 / 合并。
流水线示例:
第一步:用 pdf-creator 把这三章 Markdown 各转成 PDF。 第二步:用 anthropic-pdf 合并它们,每页加”DRAFT”水印,页脚加页码。
路径 3:anthropic-docx + Word 导出 PDF
anthropic-docx 先生成 .docx,然后你可以用程序
(LibreOffice headless、Microsoft Word 自动化)或手动导出 PDF。
npx degit anthropics/skills/skills/docx ~/.claude/skills/docx
什么时候用:
- 交付物首先是 Word 文档(法律函件、咨询报告),PDF 只是分发格式。
- 需要源文档里的修订追踪 / 批注,不只是 PDF。
- 接收方可能要改源文档,而他们在 Microsoft Word 里工作。
- 需要 letterhead(Word 处理这个比 HTML/CSS 干净)。
流水线示例:
用 anthropic-docx 起草一份 6 页咨询报告:封面、目录、三个章节带子标题、 内嵌图表、自定义 letterhead。我之后在 Word 里导出 PDF。
并排对比
| 需求 | 路径 |
|---|---|
| 中文 / CJK 内容正确渲染 | pdf-creator |
| 印刷级长文档 | pdf-creator |
| 修改已有 PDF | anthropic-pdf |
| Letterhead、批注、修订追踪 | anthropic-docx |
| 输出在 Word 里被消费 | anthropic-docx |
| 填 PDF 表单 | anthropic-pdf |
| OCR 扫描版 PDF | anthropic-pdf |
| 只是 HTML → PDF(英文内容) | pdf-creator(版式还是赢) |
常见坑
Pandoc + LaTeX 不在这个清单里是有原因的。 英文学术论文能用,但中文坏得彻底——
XeLaTeX 字体配置出了名的脆。如果你们团队有现成 pandoc + xeCJK 流水线,留着用。
如果重新开始,pdf-creator 跳过整个泥潭。
LibreOffice headless 转换(soffice --convert-to pdf)对复杂版式不可靠,
但简单 .docx → PDF 没问题。配合 anthropic-docx 走”文档优先”工作流。
@page CSS 选择器是 pdf-creator 的秘密武器。多数 Markdown → PDF 流水线
把文档当连续流处理。WeasyPrint 尊重命名页、running headers/footers、
page-break-before 等——这就是为什么输出看起来像真正的文档,而不是一张长截图。
三者组合
双语分发的研究报告:
anthropic-docx— 在 Word 里起稿编辑评审。- 用 LibreOffice headless 导出
.docx→ PDF。 anthropic-pdf— 加水印、页码、加密。
中文为主的个人笔记归档:
- 写 Markdown。
pdf-creator— 渲染成中文字体正确的印刷级 PDF。anthropic-pdf— 多份笔记合并成季度归档。
对外发布的英文报告:
- Markdown 草稿。
pdf-creator— 渲染时用品牌风格的 CSS。anthropic-pdf— 加密、加元数据。
浏览全部 PDF 相关 skill →