aipptskill.

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
修改已有 PDFanthropic-pdf
Letterhead、批注、修订追踪anthropic-docx
输出在 Word 里被消费anthropic-docx
填 PDF 表单anthropic-pdf
OCR 扫描版 PDFanthropic-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 等——这就是为什么输出看起来像真正的文档,而不是一张长截图。

三者组合

双语分发的研究报告:

  1. anthropic-docx — 在 Word 里起稿编辑评审。
  2. 用 LibreOffice headless 导出 .docx → PDF。
  3. anthropic-pdf — 加水印、页码、加密。

中文为主的个人笔记归档:

  1. 写 Markdown。
  2. pdf-creator — 渲染成中文字体正确的印刷级 PDF。
  3. anthropic-pdf — 多份笔记合并成季度归档。

对外发布的英文报告:

  1. Markdown 草稿。
  2. pdf-creator — 渲染时用品牌风格的 CSS。
  3. anthropic-pdf — 加密、加元数据。

浏览全部 PDF 相关 skill →