把 Markdown 变成带目录页的品牌 PDF

把 Markdown 变成带目录页的品牌 PDF

一个把 Markdown 变成成品 PDF 的 n8n 工作流。你把 Markdown 和标题发到一个网址。工作流给标题编号，加上封面和目录页，让 PDFMint 渲染文件，并用 PDF 本身来回复。

包里有什么

• workflow.json：n8n 导出的工作流，20 个节点，其中九个是便签。里面没有任何凭据。一张便签是带设置步骤的长概览，其余的是每个步骤上方的简短底框。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

• 两个 PDFMint 节点原来关联着作者 n8n 里的一个凭据。这个关联已删掉，请选你自己的。
• webhook 原来带着保存下来的测试数据，也就是固定数据。它已删掉，所以第一次运行用的是你发的内容。
• Webhook 的 id 已删掉，导入文件时 n8n 会生成新的。
• 第一张便签原来用第一人称写明了是谁写的这个模板。这一行已删掉。
• 别的都没改。节点、代码和连线都和原来的副本一样。

开始之前

• 一个能接收网络请求的 n8n 实例，n8n Cloud 或自己的服务器都行。
• PDFMint 社区节点 n8n-nodes-pdfmint。PDFMint 的文档称它是已验证节点，所以 n8n Cloud 可以从节点面板添加。在自己运行的 n8n 上，到 Settings、Community nodes 里安装。
• 一个 PDFMint 账号和它的 API 密钥。免费套餐每月可生成 10 份文档，不需要银行卡。

设置

1. 如果你的 n8n 还没有 PDFMint 社区节点，先安装它。
2. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
3. 添加一个 PDFMint 凭据，填上你的 API 密钥。在 Check remaining quota 和 Render the Markdown as PDF 里选中它。
4. 打开 Set your document branding，改品牌名、强调色、页面格式、目录开关和水印。别的都不用改。
5. 在触发器上点 Execute workflow，或者发布这个工作流。发一个 POST 请求，JSON 正文里带 markdown、title，也可以带 author。
6. 把回复存成一个 .pdf 文件并打开。

在终端里发请求大致如下，地址换成你自己的 webhook：

curl -X POST "<YOUR_WEBHOOK_URL>" -H "Content-Type: application/json" -d '{"markdown":"## Intro\nHello","title":"Test"}' -o test.pdf

一次运行的过程

1. Receive the Markdown document 在路径 markdown-to-pdf 接收 POST，并等某个节点来回复它。
2. Set your document branding 存着品牌名、强调色、页面格式、目录开关和水印。它还把请求正文存在一个叫 request 的字段里。
3. Check the request is usable 要求 markdown 和 title 都不为空。缺任何一个，运行就走到 Explain what went wrong。
4. Check remaining quota 向 PDFMint 查询剩余额度，Is there quota left? 只有在数字大于零时才继续。
5. Build the cover, contents and body 在一个 Code 节点里完成所有工作。它给每个二级和三级标题编号，并跳过围栏代码块里的标题。它用同样的编号生成目录，并统计字数。它按每分钟 200 字估算阅读时间。它还写出一个封面块，并根据你的强调色写出页眉和样式表。
6. Render the Markdown as PDF 把结果发给 PDFMint，带上页面格式、20 毫米页边距、形如 Page 1 of 3 的页码、页眉、CSS、标题和作者，以及水印文字。
7. Did the render succeed? 检查回复里有没有错误。Return the PDF 用文件本身回复请求。否则 Explain what went wrong 和 Return the error as JSON 用一个状态码和一个原因来回复。

改变风格

• 品牌名、颜色、页面格式、目录和水印：Set your document branding 的字段。
• 封面、目录和标题：Build the cover, contents and body 里的代码。
• 页边距、页码和页眉：Render the Markdown as PDF 的选项。
• 文件交到哪里：把 Return the PDF 换成 Gmail、Google Drive 或 S3 节点。
• 夜间报告：把 webhook 换成 Schedule Trigger。

注意事项

• 地址是开放的：webhook 没有登录验证。任何知道它地址的人都能生成 PDF 并花掉你的额度。发布之前，请在 Webhook 节点上设置一种验证方式。
• 套餐：PDFMint 的文档（2026 年 11 月 12 日查阅）列出，免费版 0 美元，每月 10 份文档，Starter 版 9 美元，5000 份。Pro 版 29 美元，50000 份，Scale 版 99 美元，250000 份。渲染之前先预留一个额度，渲染失败会退回。
• 额度检查：读取账户不花额度。如果渲染时额度还是用光了，PDFMint 会返回 402，这个工作流随后把渲染报告为失败。
• 标题：只有二级和三级标题会被编号，只有一个标题的文档没有目录页。强调色必须是形如 #123a5f 的十六进制值，否则代码会退回到这个颜色。
• 中文、日文、韩文和 emoji：PDFMint 的文档说它的渲染器带有这些字体。
• 你的数据：Markdown 会发到 PDFMint 的服务器。
• 没运行过：这里没有对 PDFMint 运行过任何东西。这些说明来自文件、n8n 的源码和 PDFMint 的文档（2026 年 11 月 12 日查阅）。