--- title: "Markdown 转 PDF 转换器" description: "Markdown 转 PDF 是一款浏览器打印转换器：粘贴 Markdown，选好纸张大小和主题，然后用打印 / 另存为 PDF。文档在本地打印，不上传任何内容。" url: https://markitdown.ai/markdown-to-pdf updated: 2026-09-26 source: markitdown.ai --- # Markdown 转 PDF 转换器 > Markdown 转 PDF 是一款浏览器打印转换器：粘贴 Markdown，选好纸张大小和主题，然后用打印 / 另存为 PDF。文档在本地打印，不上传任何内容。 ## 如何把 Markdown 转 PDF - 把 Markdown 粘贴进编辑器。选择纸张大小（A4 或 Letter）、页边距、方向和主题——预览会在本地更新。 - 复核分页预览。打印前检查分页、跨页的表格和多语言文本。 - 在浏览器里打开打印 / 另存为 PDF。在本地打印——不上传任何内容——PDF 来自你浏览器的打印引擎，而不是我们的服务器。 ## 为什么用这款 Markdown 转 PDF 转换器 一个 Markdown 文件本身没有页面几何信息。这款转换器加上纸张大小、页边距和分页规则，再把结果交给你浏览器的打印引擎。 - 本地打印，不上传任何内容 — PDF 来自你浏览器的打印引擎。Markdown 永远不会离开你的设备。 - 纸张大小与页边距 — 打印前选择 A4 或 Letter、纵向或横向，以及普通、窄或宽的页边距。 - 适配不同文档的主题 — Github、document 和 compact 主题会改变字体、间距和代码块配色，而不改变 Markdown 本身。 - 页码 — 在每一打印页的角落或居中加上页码，样式与当前主题匹配。 - 感知 CJK 的字体栈 — 打印样式表把中文、日文和韩文系统字体排在拉丁回退字体之前，适配混排文字的报告。 - 与 API 相同的 HTML 渲染器 — 文档由与 POST /v1/convert/markdown/html 相同的净化 HTML 构建，再包进你的浏览器会转成 PDF 的打印 CSS。 ## 为什么 Markdown 打印前需要分页规则 - Markdown 没有页面几何信息 — 一个 Markdown 文件描述的是标题和段落，不是纸张大小、页边距，或页面应该在哪里断开。 - 长表格和代码块断得很糟 — 没有分页规则，一行表格或一个围栏代码块可能在打印页底部被切成两半。 - CJK 与混排文字需要合适的字体 — 中文、日文和韩文文本在不同浏览器和操作系统之间，可能回退成缺失字形或不同的断行行为。 ## 这款 Markdown 转 PDF 转换器保留什么 - 页面大小与页边距 — 一个 @page 规则会在你的浏览器打开打印对话框之前设定纸张大小（A4 或 Letter）、方向和页边距。 - 标题可以另起一页 — 一级标题默认可以分页到新的一页，所以每个顶层章节都干净地开始；文档的第一个标题不会。 - 表格与代码避免页中断开 — 表格和围栏代码被标记为不在内部断开，所以浏览器会把整块移到下一页，而不是把它劈开。 - 用 CSS 计数器做页码 — 可选的页码由一个 CSS 页面计数器生成，定位在页面页脚的左、中或右。 - 与 API 相同的净化 HTML — 可打印文档由 POST /v1/convert/markdown/html 所用的同一套净化 CommonMark 与 GFM HTML 构建。 ## Markdown 转 PDF 的使用场景 凡是 Markdown 笔记需要变成一份别人不用 Markdown 阅读器就能打开的分页文件的地方。 - 报告与研究笔记 — 把一份 Markdown 报告变成分页 PDF，发给没有 Markdown 阅读器的人。 - 多语言文档 — 用感知 CJK 的字体栈，打印混有中文、日文或韩文文本的拉丁文字笔记。 - 从 README 做快速讲义 — 为文档或 README 生成一份可打印版本，无需安装单独的 PDF 工具。 - 归档一条 Markdown 笔记 — 在笔记进一步变化之前，存下一份带日期、分页的快照，不必把它上传到任何地方。 ## 浏览器打印 这款工具在你的浏览器里构建一份可打印文档，并交给浏览器自己的打印 / 另存为 PDF 对话框。服务端 PDF 生成已在规划中但尚未上线，所以 API 目前没有 PDF 端点。如果你今天就需要从自动化流水线得到 PDF，用 POST /v1/convert/markdown/html 渲染净化 HTML，再用你自己掌控的工具打印那段 HTML，或者交互式地使用本页处理一次性文档。如果服务端端点将来上线，这一节会更新；在那之前，请把浏览器打印路径当作本产品 Markdown 转 PDF 唯一受支持的途径。 ## 纸张、页边距、主题 纸张大小和页边距决定段落、表格和代码在每一页上有多少空间：更窄的页边距每页装得更多，却可能让一张密集的表格显得拥挤；更宽的页边距读起来更舒服，代价是页数增加。三个主题会改变字体、间距和代码块背景，而不触碰 Markdown 本身，所以切换主题是一种安全的方式，用来对比一份紧凑的内部笔记和一份面向外部读者的文档。每次改动后都要检查分页预览，因为在短笔记里看起来没问题的设置，放到更长的报告里可能就把一张表推到分页处。 - A4 适合大多数非美国读者；Letter 适合以美国为中心的文档。 - 窄页边距每页装更多内容；宽页边距读起来更舒服。 - 页码能让一份打印装订的报告保持顺序。 ## 多语言与代码 混有中文、日文或韩文字符的 Markdown，取决于实际打印它的那台机器上装了哪些字体，所以同一份文件在两台电脑上可能分页略有不同，即便 Markdown 源完全一样。在你将要打印的设备上检查预览，尤其是长报告，一个缺失的字形可能把标题推到错误的页面上。代码块和又长又不断开的 URL 表现类似：它们被标记为避免在行中间断开，所以浏览器会把整块移到下一页，而不是把一个读者可能复制的命令从中间劈开。 ## 这款 Markdown 转 PDF 转换器背后的打印 CSS Source: markitdown.ai 打印样式表：github 主题、A4、开启页码 ```css @page { size: A4 portrait; margin: 25mm; } @page { @bottom-center { content: counter(page); font-size: 10pt; color: var(--md-muted); } } h1 { break-before: page; } article.md-document > h1:first-child { break-before: auto; } table, pre { break-inside: avoid; } ``` ## FAQ ### Markdown 转 PDF 会上传我的文本吗？ 不会。在本地打印——生成 PDF 不上传任何内容；它完全来自你浏览器的打印引擎。 ### 有服务端的 Markdown 转 PDF API 吗？ 目前没有。POST /v1/convert/markdown/pdf 不存在，调用它会返回 404。用 POST /v1/convert/markdown/html 渲染 HTML 再打印它，或使用本页的浏览器工具。 ### 可以选择 A4 或 Letter 吗？ 可以。纸张大小、方向、页边距和页码都是编辑器里的本地选项。 ### 它能处理中文、日文或韩文文本吗？ 打印样式表把 CJK 系统字体排在拉丁回退字体之前。打印前先检查分页预览，因为字体可用性因设备而异。 ### 标题总是另起一页吗？ 默认情况下，一级标题会分页到新的一页，文档里的第一个标题除外；这一行为可以关闭。 ### 把 Markdown 打印成 PDF 需要账号吗？ 不需要。粘贴、预览和打印都不需要登录。 ### 以后会有服务端生成的 PDF 文件吗？ 服务端 PDF 生成已在规划中。今天本页使用你浏览器的打印对话框，没有服务端 PDF 端点。 ## Related - [Markdown to HTML Converter](https://markitdown.ai/markdown-to-html) - [Markdown to Text Converter](https://markitdown.ai/markdown-to-text) - [PDF to Markdown Converter](https://markitdown.ai/pdf-to-markdown)