Markdown 转 PDF：最快的方法（以及其他几种方法）
如果你只是想要一份 PDF 然后就走，直接打开 /markdown-to-pdf，把 Markdown 粘进去，点 PDF。导出的文件会完整保留标题、代码高亮、表格、数学公式与 Mermaid 图表。无需安装、无需配置模板、无需命令行 —— 任何浏览器都能用。
这是最快的路径。本文剩下的部分会解释：为什么需要做 Markdown → PDF 这一步、导出能得到什么效果，以及另外四种常见方案（Pandoc、VSCode 插件、浏览器打印、CLI 工具）各自适合什么场景。
Markdown 对写作者和评审者很友好 —— 对 Git 友好、语法干净、易于 diff。但当文档跨出工程团队，受众就变了：
- 干系人需要稳定的版式。 同一份 Markdown 在 VS Code、Notion、聊天客户端里渲染出的样子完全不同。PDF 把版式固化下来，签批文档里的页码不会因为换台机器就漂移。
- 合规与采购需要时间戳。 许多审计流程要求带日期的 PDF 物料。一旦你有了 PDF，就可以挂在工单、采购流程或董事会材料上，不需要解释「为什么是 .md」。
- 依然有打印和离线评审的人。 不少客户、法务、运营仍然习惯在纸上批注，PDF 是这场景的通用语言。
- 移动端分享。 PDF 在 iOS / Android 自带预览器里直接打开，无需 Markdown 插件。
如果你要交付的是发版说明、SLA、RFP 回复、客户报告，最终交付物通常是 PDF —— 不是 Markdown 源文件。
我们的 Markdown 转 PDF 工具 用真实的 headless Chromium 引擎渲染，所以预览是什么样，PDF 就是什么样：
- 粘贴或拖入
.md文件。 支持拖拽，单文件 1 MB 上限。 - 在右侧面板调整主题、字体、宽度。 明暗主题都能导出。如果对方要打印，把宽度调到接近 A4。
- 点 PDF。 文件直接下载。免费账户也无水印。
会被自动保留的内容：
- 标题、列表、表格、引用、链接
- 各种语言的语法高亮代码块
- 行内
code与缩进式代码 - 内嵌图片（data URI 与远程 URL 都支持）
- KaTeX 数学公式：
$$\int_0^1 x^2\,dx$$渲染成排版好的公式 - Mermaid 流程图：
```mermaid代码块渲染成 SVG 嵌入 PDF - 任务列表（
- [x]/- [ ]）
| 方案 | 适合 | 注意点 |
|---|---|---|
/markdown-to-pdf（本站） | 一次性转换、代码高亮、公式、图表 | 单文件 1 MB |
| Pandoc | 学术论文、自定义 LaTeX 模板、参考文献 | 模板配置陡峭、安装体积大 |
| VSCode「Markdown PDF」插件 | 你本来就整天在 VSCode 里 | 后台静默下载 Chromium、首次启动慢 |
| 浏览器打印 → 另存 PDF | Markdown 已经在浏览器里渲染好 | 分页会切断表格、代码块颜色容易丢 |
md-to-pdf（npm CLI） | 构建流水线、CI/CD | 依赖 Node + headless Chrome、主题需要 YAML front-matter |
如果你只需要做一次 PDF 然后转头去做别的，浏览器版工具摩擦最小。如果你每周要从同一个模板生成 50 份 PDF，那学一下 Pandoc 是值的。我们另外写了一篇 五种方法详细对比，需要细节可以看那里。
导出前值得知道的六个坑：
- 表格保持窄。 A4 可打印宽度大概 6.5 英寸。一个宽对比表要么被压缩到看不清，要么直接溢出页面。把宽表改成竖排列表或者拆成多页。
- 用
## H2当作逻辑分页符。 大多数 Markdown → PDF 工具（包括我们）允许在导出设置里用 H2 强制分页。如果你的工具不支持，可以手动加<div style="page-break-before: always;"></div>。 - 图片分辨率要够，尤其是要打印的。 用 2x 位图或矢量 SVG，打印出来才不会糊。屏幕预览会骗人。
- 小心相对图片路径。 如果
.md引用了./images/diagram.png，转换器要能取到这个路径。要么把图片内嵌成 data URI，要么先上传到 CDN。 - 公式和 Mermaid 先用一段做小测试。 如果 KaTeX 或 Mermaid 没加载，你想在 50 行的草稿上发现，而不是 50 页的发版稿上。
- 导出后跑一遍打印预览。 一份 PDF 在屏幕上看着没事，真打印出来可能页边距、页码、连字会出问题。
Markdown 转 PDF 是免费的吗？
是的。我们的转换器 免费且无需注册，免费账户也能导出无水印 PDF。
有不需要安装任何东西的方法吗？
有 —— 浏览器版工具完全不用本地装东西。Pandoc、VSCode 插件、CLI 方法都需要本地安装。
导出的 PDF 会保留代码高亮吗？
会。语法高亮是在 PDF 截取之前就完成渲染的，颜色会带过去。我们另外写了一篇 Markdown 转 PDF 保留代码高亮 可以深入看。
能把多个 .md 文件合成一个 PDF 吗？
网页工具一次处理一个文件。批量任务（比如 20 章合成一个 PDF）请看 批量把 Markdown 文件转 PDF。
文件会被上传到服务器吗？
转换在加固的服务端 Chromium 运行时中完成 —— 输入仅在内存中处理，不会写入长期存储。
有文件大小限制吗？
单次请求 Markdown 输入限制 1 MB。一份 1 MB 的 Markdown 通常生成 50–200 页 PDF。
一句话总结：别再走 Markdown → PNG → 手工拼 PDF 的弯路了。 现代的 headless Chromium 工具（包括本站的 Markdown 转 PDF）能直接从 .md 到 .pdf，代码高亮、数学公式与图表都完整保留。需要真正的 LaTeX 模板时再上 Pandoc；其他 95% 的场景，浏览器版工具就够用。