Markdown 转 PDF：浏览器、批量导出与 CLI 工作流
从 Markdown 导出 PDF，比较浏览器、Pandoc、编辑器与 CLI 工作流，分清多文件 ZIP 和合成一份文档，并检查分页、字体、代码与表格。以项目交接示例展示实际输出，说明免费无水印次数、Creator 订阅与批量工具的适用范围。
打开 Markdown 转 PDF 工具，粘贴文档、选择外观并导出 PDF。先用下方示例检查标题、表格和页面布局，无需安装本地转换器。
本文说明下载文件需要检查什么，以及 Pandoc、VS Code 扩展、浏览器打印、本地 CLI 和浏览器批量导出各适合什么任务。
Markdown 对写作者和评审者很友好 —— 对 Git 友好、语法干净、易于 diff。但当文档跨出工程团队，受众就变了：
- 干系人需要稳定的版式。 同一份 Markdown 在 VS Code、Notion、聊天客户端里渲染出的样子完全不同。PDF 把版式固化下来，签批文档里的页码不会因为换台机器就漂移。
- 合规与采购需要时间戳。 许多审计流程要求带日期的 PDF 物料。一旦你有了 PDF，就可以挂在工单、采购流程或董事会材料上，不需要解释「为什么是 .md」。
- 依然有打印和离线评审的人。 不少客户、法务、运营仍然习惯在纸上批注，PDF 是这场景的通用语言。
- 移动端分享。 PDF 在 iOS / Android 自带预览器里直接打开，无需 Markdown 插件。
如果你要交付的是发版说明、SLA、RFP 回复、客户报告，最终交付物通常是 PDF —— 不是 Markdown 源文件。
使用 Markdown 转 PDF 工具预览 Chromium 渲染效果，再检查下载文件的分页与字体：
- 粘贴内容或拖入
.md文件，输入上限为 1 MB。 - 在预览中选择主题、字体与宽度。
- 导出 PDF 并检查下载文件。
会被自动保留的内容：
- 标题、列表、表格、引用、链接
- 各种语言的语法高亮代码块
- 行内
code与缩进式代码 - 内嵌图片（data URI 与远程 URL 都支持）
- KaTeX 数学公式：
$$\int_0^1 x^2\,dx$$渲染成排版好的公式 - Mermaid 流程图：
```mermaidblocks render as SVG inside the PDF - Task lists (
- [x]/- [ ])
| 方法 | 适合任务 | 主要取舍 |
|---|---|---|
/markdown-to-pdf | 含代码、公式、图表的单份文档 | 1 MB 输入；浏览器导出规则 |
/batch-export | 每次最多 15 个文件，各自输出 | 付费；ZIP 内是独立文件 |
| Pandoc | 引用、书籍、受控模板 | 需要 PDF 引擎与模板设置 |
| VS Code Markdown PDF | 从编辑器直接导出 | 扩展设置影响效果 |
| 浏览器打印 | 已正确渲染的网页 | 打印 CSS 与分页有差异 |
md-to-pdf | 脚本与 CI | 需要 Node.js 与浏览器运行环境 |
需要深入选型时，参阅五种 PDF 方法对比。安装体积与导出耗时会随环境变化，请用自己的文档验证。
- 表格不要超出选定页面宽度。
- 打印用图片应有足够清晰度。
- 修正相对图片路径或配置资源查找目录。
- 长文导出前先测试 KaTeX 与 Mermaid。
- 检查 PDF 的分页、代码裁切、字体和链接目标。
代码配色选项因工具而异：Pandoc 使用 --syntax-highlighting，VS Code Markdown PDF 使用 markdown-pdf.highlightStyle，md-to-pdf 使用 --highlight-style。详见代码高亮指南。
单文档工具接受最多 1 MB 的 Markdown，通过服务端 Chromium 渲染。请在输出中检查表格、代码高亮、KaTeX、Mermaid、图片和任务列表。登录后可累计获得 5 次无水印浏览器导出，用完后仍可无限次导出带水印文件。Creator 为每月 9 美元，包含不限次数的浏览器无水印导出；1 美元通行证提供 1 次浏览器无水印导出。API 积分单独计算。
服务端渲染会把文档传到本地浏览器之外处理。提交机密材料前，请阅读当前隐私与保留政策。
需要安装软件吗？ 不需要。单文档转换器和付费批量工具都可在浏览器中使用。
多文件或合成一份 PDF 怎么做？ 多文件请打开批量导出：这是付费工具，每次最多接收 15 个 Markdown 文件，下载的 ZIP 中每个输入对应一个输出。Creator 每月含 20 次运行。选择 PDF 可得到多份独立 PDF；需要合成一份文档时使用 Pandoc。 两种流程见批量转换指南。
代码、公式与 Mermaid 能保留吗？ 工具支持这些内容，但仍需测试实际主题、字体、远程图片与图表语法。
单份文档用在线转换器，一小组文件用浏览器批量导出，大量引用或合并书籍用 Pandoc，脚本重建用 md-to-pdf。扩大处理规模前先验证有代表性的导出结果。
这份演示文档把范围清单与负责人表格放在同一页。粘贴到 PDF 工具后，对照下方输出，再用于真实交接。
# Project handoff
## Approved scope
- Release documentation
- API example review
| Deliverable | Owner |
|:--|:--|
| Guide | Content team |
| Sample | Engineering |
> Demo document, not a real project report.
输出把范围与负责人表放在一起展示。请打开 PDF 检查分页与链接行为，图片预览无法单独验证这些细节。
上文的产品限制与命令已按以下当前一手资料核对：
打开 MarkdownToImage 渲染 Markdown，再按工作流选择输出格式。批量自动化前，先用一份有代表性的文档验证。