Markdown 转 PDF 在线转换器
免费在线将 Markdown 转换为 PDF。粘贴 Markdown 或上传 .md 文件，检查分页预览，直接在浏览器中保存文字可选中的 PDF。
“保存为 PDF”会打开浏览器的打印对话框。将目标打印机设为“另存为 PDF”，然后保存。PDF 由你的浏览器在你的设备上生成。
- 在浏览器中运行
- 免费，无水印
- 无需账号
- PDF 中的文字可选中
如何将 Markdown 转换为 PDF
在上方粘贴 Markdown 或上传 .md 文件，检查页面预览，选择保存为 PDF，然后在打印对话框中将目标打印机设为“另存为 PDF”，即可将 Markdown 转换为 PDF。转换在浏览器中进行，文件不会被上传，PDF 中的文字也可以选中。
- 粘贴 Markdown，或将
.md文件拖到编辑器中。 - 选择纸张大小（Letter、A4 或 Legal）、方向、页边距和主题。
- 选择“保存为 PDF”，将目标打印机设为“另存为 PDF”，然后保存。
使用方法
三个步骤，无需账号，也不上传文件。
添加 Markdown
将 Markdown 粘贴到编辑器中，或将 .md 文件拖到编辑器上。
设置页面
选择纸张大小、方向、页边距和主题。预览会按打印效果显示每一页。
保存为 PDF
选择“保存为 PDF”，然后在浏览器的打印对话框中将目标打印机设为“另存为 PDF”。
从 Markdown 到分页文档
预览会把文档排到真实的页面上，保存前就能看到每一处分页。
---
title: Project Handbook
author: Platform Team
---
# Goals
1. Ship the billing export
2. Cut p95 latency to 200 ms
| # | Task | Owner |
| --- | --- | --- |
| 1 | Freeze branch | Maya |项目手册第 1 页，共 3 页
目标简洁主题
- 上线账单导出功能
- 将 p95 延迟降至 200 ms
| # | 任务 | 负责人 |
|---|---|---|
| 1 | 冻结分支 | Maya |
表格延续到下一页时，标题行会重复显示。
转换器能处理的内容
打印 Markdown 时，通常就是这些部分会出问题。
真实的页面布局
Letter、A4 或 Legal 纸张，纵向或横向，三种页边距，带页码和页眉。
跨页表格
长表格在行与行之间分页，不会把一行截断，每页都会重复标题行。
代码高亮
围栏代码块保留语法高亮颜色，长行会自动换行以适应页面。
公式和图表
KaTeX 公式和 Mermaid 图表都会渲染，图表保持为清晰的矢量图形。
标题页和目录页
根据 YAML front matter 生成标题页，目录页显示真实页码。
文字可选中
PDF 由浏览器的打印引擎生成，因此文字可以选中和搜索。
能转换什么，有哪些限制
大多数文档的输出效果与预览一致。
可转换
- 标题、段落、粗体、斜体、删除线、高亮和链接
- 表格按行分页，并重复标题行
- 带语法高亮的代码块，自动换行以适应页面
- KaTeX 公式和 Mermaid 图表
- 任务列表、脚注、引用块、定义列表和 emoji
- 来自
https://URL 和 data URI 的图片
可转换，但有限制
- 文件通过打印对话框保存，而不是直接下载
- 网页无法加载相对路径的图片（
./img.png） - 很长的文档需要几秒钟排版
- 字体由所选主题决定，不能使用你自己的字体
- 出于安全考虑，原始 HTML 和脚本会被移除
在任何系统上将 Markdown 转换为 PDF
本页在任何现代浏览器中的效果都相同。以下是本地替代方案。
在 Mac 上
- 浏览器：使用 Safari、Chrome 或 Firefox，在打印对话框中保存为 PDF。
- Pandoc：先运行
brew install pandoc，再运行pandoc notes.md -o notes.pdf（需要 MacTeX 或 BasicTeX，或使用其他--pdf-engine）。 - Markdific 应用：导出为 PDF，文件旁边的图片也会包含在内。
在 Windows 上
- 浏览器：使用 Edge 或 Chrome，将目标打印机设为“另存为 PDF”。
- Pandoc：运行
winget install --id JohnMacFarlane.Pandoc并安装 MiKTeX，再运行pandoc notes.md -o notes.pdf。 - Markdific 应用：从 Microsoft Store 获取；导出 PDF 包含在一次性购买中。
在 Linux 上
- 浏览器：Chrome、Chromium 和 Firefox 都可以从打印对话框保存为 PDF。
- Pandoc：安装
pandoc和一个 TeX Live 软件包，再运行pandoc notes.md -o notes.pdf。
VS Code、Obsidian 和 GitHub
- VS Code：Markdown PDF 扩展会在命令面板中添加导出命令。
- Obsidian：笔记菜单中有“导出为 PDF”，使用 Obsidian 自己的主题。
- GitHub README：打开文件，选择 Raw，复制文本后粘贴到这里。
问题排查
打印对话框中常见问题的解决方法。
| 问题 | 解决方法 |
|---|---|
| 图片缺失 | 网页无法读取 ./img/chart.png 这样的相对路径。请使用完整的 https:// URL，将图片嵌入为 data URI，或从 Markdific 桌面应用导出。 |
| 页面边缘出现日期或网址 | 在打印对话框的设置中关闭页眉和页脚。 |
| 颜色或代码高亮缺失 | 在打印对话框中开启背景图形（Chrome 和 Edge 中位于“更多设置”下）。 |
| PDF 的纸张大小不对 | 将打印对话框中的纸张大小设为与此处所选相同，或保持默认设置。 |
| 标题单独留在页面底部 | 在标题上方添加 <!-- pagebreak -->，让它从新的一页开始。 |
Markdown 转 PDF 常见问题
Markdown 转 PDF 转换器免费吗？
免费。无需注册，无水印，也没有每日次数限制。打开页面，想生成多少 PDF 都可以，用完关闭标签页即可。
我的文件会被上传吗？
不会。Markdown 由浏览器中的 JavaScript 渲染和分页，PDF 由浏览器自带的打印引擎生成，不会向服务器发送任何内容。Markdown 中通过 URL 链接的图片会从其托管位置加载，这与普通网页相同。
为什么会打开打印对话框，而不是直接下载文件？
PDF 由浏览器的打印引擎生成，得到的是文字可选中的真正矢量 PDF。若要一键下载，就只能把文件上传到服务器，或者把每一页转换成图片。在打印对话框中，将目标打印机设为“另存为 PDF”（Chrome 和 Edge）、“PDF”（Safari）或“保存为 PDF”（Firefox），然后保存。
PDF 中的文字可以选中和搜索吗？
可以。文字、代码和公式都保持为真正的文本，而不是图片，因此可以选中、复制和搜索。图表保持为矢量图形，放大后依然清晰。
长表格会跨页显示吗？
会。表格在行与行之间分页，不会把一行截成两半，表格延续到的每一页顶部都会重复标题行。长表格不会整体跳到下一页而留下一大块空白。
支持公式、代码和 Mermaid 图表吗？
支持。$ 和 $$ 之间的 LaTeX 公式由 KaTeX 渲染，围栏代码块保留语法高亮颜色，mermaid 代码块会绘制为图表。
可以选择纸张大小和页边距吗？
可以。可选择 Letter、A4 或 Legal 纸张，纵向或横向，以及窄（0.5 英寸）、标准（0.75 英寸）或宽（1 英寸）页边距。预览会随之更新，准确显示每一页的分页位置。
可以添加页码、标题页或目录吗？
可以。页码默认开启。标题页使用 YAML front matter 中的标题、副标题、作者和日期，如果没有，则使用第一个标题。目录页列出各个标题及其起始页码。
如何开始新的一页？
在需要开始新页的位置，单独一行写上 <!-- pagebreak --> 或 \newpage。
图片会显示在 PDF 中吗？
通过完整 https:// URL 链接的图片和以 data URI 嵌入的图片都会显示在 PDF 中。./images/chart.png 这样的相对路径指向你电脑上的文件，网页无法读取，这类图片请改用完整 URL，或使用 Markdific 桌面应用。
为什么页面边缘会出现日期或网址？
那是浏览器自己的页眉和页脚。在打印对话框的设置中关闭“页眉和页脚”即可。本工具生成的页码和页眉属于页面内容，会保留。
如何将 MD 文件转换为 PDF？
打开本页，选择“打开 .md”（或将 .md 文件拖到编辑器上），在预览中检查页面，然后选择“保存为 PDF”，并在打印对话框中将目标打印机设为“另存为 PDF”。.md 文件就是纯 Markdown 文本，任何 .md 文件都可以转换。
如何将 GitHub README 转换为 PDF？
在 GitHub 上打开 README，选择 Raw，复制文本。粘贴到这里，然后保存为 PDF。README 中使用相对路径的图片无法加载，请先将每张图片替换为完整的 https://raw.githubusercontent.com/ 地址。
可以改用 Pandoc 将 Markdown 转换为 PDF 吗？
可以。Pandoc 在命令行中转换，例如 pandoc notes.md -o notes.pdf。它默认使用 LaTeX 生成 PDF，因此需要安装 LaTeX 发行版，也可以用 --pdf-engine 选项选择其他引擎。本页无需安装，并且在保存前就能看到页面效果。
将 Markdown 转换为 PDF 的最佳方法是什么？
转换单个文件时，本页这样的浏览器转换器最快：无需安装，有页面预览，生成的 PDF 文字可选中。用脚本处理或文件较多时，通常使用命令行中的 Pandoc。含有本地图片的文件，可以用 Markdific 这样的桌面应用导出，图片会一并包含。
不用 Pandoc 或 LaTeX，可以将 Markdown 转换为 PDF 吗？
可以。本转换器无需安装。它在浏览器中渲染 Markdown 并排版页面，再由浏览器的打印引擎生成 PDF。
代码块在 PDF 中会保留格式吗？
会。围栏代码块保留等宽字体、缩进和语法高亮颜色，长行会自动换行以适应页面。如果颜色缺失，请在打印对话框中开启“背景图形”。
转换机密文档安全吗？
Markdown 在浏览器中处理，不会发送到服务器，因此文档始终留在你的设备上。Markdown 中通过 URL 链接的图片会从其托管位置加载。
可以在手机上使用吗？
可以。粘贴或上传 Markdown，然后点按“保存为 PDF”。手机会打开打印界面，你可以在那里保存或分享 PDF。
