如何把 Markdown 转成 PDF（免费，代码块和表格完好）

把 Markdown 转成排版精美的 PDF——README、笔记和文档的代码块与表格都正确渲染。免费、浏览器完成、免注册。

把 Markdown 文件转成排好版的 PDF — 朴素的 .md 进 → 排好版的 PDF 出

Markdown 是东西被写出来的地方——README、会议记录、规格书、文档。 PDF 是东西被发出去的地方：发给打不开 .md 文件的客户、要附件的经理、打印机。两者之间只隔一次转换，而你不该为了跨过去就安装 pandoc 和一整套 LaTeX 发行版。

多数快捷路线的坑在于，它们弄坏的恰恰是技术文档赖以生存的部分：代码块塌成比例字体、管道表格印成一墙 | 字符、嵌套列表被压平。转换器只有在代码和表格都活下来时才有用——这篇指南就按这个标准衡量一切。

转换分步教程

打开工具

打开 pdfty.com/tools/markdown-to-pdf。20 MB 以内免费——20 MB 的 Markdown 都能写本小说了，等于不限量。

拖入 .md 文件

接受 .md 和 .markdown 文件。文件经 HTTPS 上传，1 小时后删除。

转换自动运行

Markdown 被解析（表格、围栏代码和语法高亮都包含），再用一套干净的内置样式排版。只要几秒。

下载 PDF

一份带正经标题、代码块、表格和分页的 PDF。

检查一遍

扫一眼有没有依赖你编辑器私有渲染的东西——见下面的注意事项。

pdfty 的 Markdown 转 PDF 工具 — 上传 .md 文件，下载排好版的 PDF——不用 pandoc、不用 LaTeX

具体渲染什么

转换器支持标准 Markdown，外加技术写作要紧的扩展：

标题 —— 层级分明的字号，H1 和 H2 下有细分隔线
围栏代码块 —— 等宽字体、浅灰背景、缩进原样保留，常见语言有语法高亮
行内代码 —— 熟悉的灰色小块样式
表格 —— GitHub 风格的管道表格变成带边框的表格，表头行有底色
引用块 —— 左边框、弱化的文字
列表 —— 有序、无序、嵌套
链接 —— 在 PDF 里保持可点击
URL 引用的图片 —— ![](https://…) 的图片会被抓取并嵌入

页面按舒适的阅读宽度排版、页边距慷慨——更像「看起来已完成的内部文档」，而不是浏览器的原始打印稿。

不渲染什么

诚实环节。Markdown 有方言，这个工具实现的是标准 Markdown + 表格 + 围栏代码，不是完整的 GitHub 风味：

任务列表（- [ ] todo）按字面方括号打印，不是复选框。
删除线（~~text~~）不转换——波浪号原样保留。
本地图片（![](./diagrams/arch.png)）出不来：你上传的是一个文件，服务器摸不到你磁盘上它旁边的文件。把图托管到一个 URL，否则就接受那里是个空缺。
Mermaid / 数学块渲染成普通代码块，不是图或公式。
没有自定义主题——一套内置样式，不能上传 CSS。

免费的本地替代方案

pandoc —— 转换器的正典：pandoc README.md -o readme.pdf。输出一流、配置无限，但 PDF 输出需要 LaTeX 引擎（经常是 1–4 GB 的安装）。每周都转文档的话值得；为一个 README 就离谱了。

VS Code 扩展（如「Markdown PDF」）——已经住在 VS Code 里的话很方便；输出质量因扩展和主题而异。

浏览器预览 + 打印： 在任何能预览的地方渲染 Markdown（很多编辑器能起 HTML 预览），然后 Ctrl/Cmd+P → 另存为 PDF。免费又本地，但你继承浏览器的打印怪癖：不手动关掉就有 URL 页眉页脚，分页还会落在代码块中间。

macOS： 没有内置 Markdown 渲染器——预览和文本编辑把 .md 当纯文本，你看到的会是原始的井号和星号。

实用注意事项

分页是自动的。 长代码块可能跨页断开。没有手动分页标记；引擎在需要处断行。
特别宽的表格和超长代码行会在内容宽度处被缩放或截断——200 字符的表格行没法体面地塞进竖版页面。能缩短就缩短。
Front matter（文件顶部的 --- YAML）被当作内容处理，不会隐藏——不想它被印出来就先删掉。（最顶上的 --- 块也可能被渲染成一条水平线加文字，取决于格式。）
Emoji 短代码如 :rocket: 保持字面原样；直接粘贴的 emoji 字符一般能渲染。
检查链接目标。 相对链接（[docs](./docs/setup.md)）以链接形式存活，但打印出来之后指向的地方毫无用处。

PDF 一旦出炉，常规工具箱就都能用了：用 页眉页脚 盖上页码计数器、用合并拼章节，或者给图多的那份瘦身——用压缩。

常见问题

代码块保留语法高亮吗？

保留——带语言提示的围栏块（```python）有彩色高亮；不带提示就是灰底等宽纯文本。无论哪种，缩进都原样保留。

表格真的渲染成表格吗？

真的——管道表格（GitHub 风格）变成带边框、表头行有底色的表格。对齐冒号会被解析器遵循。

为什么 PDF 里我的图不见了？

它是按本地路径引用的。上传的只有一个 .md 文件，./images/x.png 指向虚空。用完整的 https:// URL，或者在本地用 pandoc 转——那里相对路径解析得了。

能直接转 GitHub 上的 README 吗？

先下载原始 .md 文件，再上传。托管在完整 URL 上的徽章和图片通常能带过来；GitHub 专属功能（任务列表、mermaid）不行——见上面的清单。

能改字体、页边距或颜色吗？

这个工具里不能——它只配一套刻意干净的样式。要品牌化设计，带着你自己的 CSS 走 HTML 转 PDF。

有大小或页数限制吗？

免费：单文件 20 MB、每天 10 次操作——对文本文件来说等于没有限制。单个 Markdown 源生成超过 50 页的输出 PDF 没有问题。

我的文档隐私安全吗？

传输走 HTTPS，文件 1 小时内自动删除。不能上传的机密材料，pandoc 是本地路线。

能反着来——PDF 转 Markdown 吗？

不能直接转。最接近的是 提取文本（纯文本、无格式），或者 PDF 转 Word 之后自己清理。