FreeMD2PDF.com
简体中文

README 转 PDF:在浏览器里完成排版。

粘贴 README.md 的内容或直接拖入文件,下载表格、代码和 Mermaid 图都排好版的 PDF。内容不会上传。

源码 · .md 可拖入 .md 文件或图片
校样 A4 · 分页以下载的 PDF 为准 实时
PDF 引擎待命
关于 Free MD2PDF

README 转 PDF

GitHub 把 README 显示得很漂亮,却没有「下载为 PDF」。直接在浏览器里打印仓库页面,文件列表、侧边栏和导航栏会一起印出来,分页也常常断在表格中间。多数时候需要的只是 README 本身:附在方案里、发给评审,或者打印出来细读。

在这里,Markdown 会被当作正式文档排版:标题变成 PDF 书签,表格保留对齐方式,代码块带语法高亮,GitHub 同样支持的 ```mermaid 代码块会变成矢量图。$…$ 公式也和 GitHub 上一样可以用。

README 转 PDF 的步骤

  1. 拿到 Markdown 原文 在 GitHub 上打开 README.md,点 Raw 后全选复制;或者直接使用本地仓库里的文件。
  2. 粘贴或拖进来 粘贴到编辑器,或把 README.md 文件拖到页面任意位置。
  3. 拖入用到的图片 把 README 引用的图片文件拖到页面上;docs/screenshot.png 这样的路径会按文件名自动匹配。
  4. 下载 PDF 点「下载 PDF」;想直接打印,点「打印」,打印的是同一份 PDF。

哪些内容能完整保留

GitHub 风格的表格和列对齐、带语法高亮的代码块、任务列表、脚注、多级列表、可点击的链接,以及 Mermaid 流程图、时序图等各类图表,都以矢量图嵌入,图中文字可以选中。在「排版」里打开「目录」就能生成目录;过宽或过高的图会缩放到页面之内,不会被截断。中文 README 使用内置中文字体,不会乱码。

图片:拖进来即可

本页面不会连接任何其他服务器,所以不会从网上下载图片。仓库里的图片很好办:把图片文件拖到页面上,README 里无论写的是哪个文件夹下的路径,都会自动对上。存放在别处的图片,包括很多 README 顶部来自 shields.io 的徽章,在 PDF 里会显示为一行「图片不可用」的提示;删掉这些行,或者把图片下载下来再拖进来。

哪些内容不会保留

不渲染原始 HTML:居中的 <p align="center"> 标题、<img> 标签、可折叠的 <details> 会原样显示成文字,这些部分请改写成普通 Markdown。GitHub 的 > [!NOTE] 提示块会变成普通引用,:rocket: 这类短代码保持原文,emoji 没有可用字体,会显示为空方框(页面会告诉你是哪些字符)。

常见问题

怎么把 GitHub 上的 README 转成 PDF?

在 GitHub 打开 README,点 Raw,全选复制后粘贴到本页编辑器,再点「下载 PDF」。如果仓库在自己电脑上,直接把 README.md 拖到页面上也可以。

README 转 PDF 后图片丢失怎么办?

docs/architecture.png 这类相对路径的图片是仓库里的文件,本页面看不到你的仓库:把图片文件拖到页面上就会嵌入。用网址引用的图片(包括徽章)不会被下载,因为这里不允许连接其他服务器。

README 里的 Mermaid 图能显示吗?

能。```mermaid 代码块在浏览器里绘制,以矢量图嵌入 PDF,和 GitHub 上显示的是同一张图。语法有误的图会显示为一个错误框,写明报错信息和行号,文档其余部分不受影响。

私有仓库的 README 也能转吗?

能。文字在当前浏览器标签页里排版,不会上传,所以不用公开仓库,也不用授权任何服务。从仓库里复制 Markdown,粘贴到这里即可。

为什么 README 里的 HTML 显示成了文字?

排版引擎没有与原始 HTML 对应的东西,所以标签会原样显示,而不会被解释。README 里的 HTML 大多只是用来排版:把居中的 logo 块换成一行普通图片,把 <details> 换成一个小标题即可。

使用场景与教程

ChatGPT 导出 PDF

把 ChatGPT 的回答连同表格、代码和公式保存为 PDF

DeepSeek 导出 PDF

把 DeepSeek 的回答连同公式和表格导出为 PDF

豆包导出 PDF

把豆包的回答转成 PDF,数学公式正常显示

Claude 导出 PDF

把 Claude 的回答和 Markdown Artifact(含 Mermaid 流程图)转成 PDF

Gemini 导出 PDF

把 Google Gemini 的回答保存为排好版的 PDF

Mermaid 导出 PDF

Mermaid 流程图以矢量图嵌入 PDF,文字可选中

Markdown 转 PDF 中文乱码

内置中文字体,中文、生僻字和繁体都能正常显示