把 Markdown 转成 PDF
Markdown 转 PDF 用 WeasyPrint 把 CommonMark 格式的 .md 文件渲染成 PDF,字体栈涵盖中文、日文和韩文。文件必须是 UTF-8。
把文件拖到这里,或点击选择
支持 MD · 单个文件不超过 500.0 MB · 一次最多 20 个文件
也可以按 Ctrl/Cmd+V 或从剪贴板菜单粘贴文件。
Markdown 转 PDF 用 `pulldown_cmark` 解析 CommonMark,把它包装成 HTML(含 Noto Sans CJK 字体栈),再用 WeasyPrint 打印这份 HTML。上传 `.md` 文件。API 也接受 Markdown 加资源的 ZIP;网站的文件选择器只列出 `.md`。
这不是 Pandoc 的复制品,也不是幻灯片引擎。表格、删除线和任务列表会渲染;脚注和 emoji 短代码等其他 GitHub 专有扩展不会被转换。页面是 A4,页边距 2 cm。围栏 HTML 里的 JavaScript 不会执行。
不是 `.md` / `.zip` 的文件名会被拒绝。Markdown 路径要求 UTF-8。加密的 PDF 是错误输入;请从 Markdown 出发。
如果你已经有 HTML,HTML 转 PDF 会跳过 CommonMark 这一步。如果你有 PDF 想要得到 Markdown,那是 PDF 转 Markdown,方向相反。
内置样式表把正文设为 11 pt、行高 1.6,文字是深灰色(`#111`),引用块用更浅的灰色(`#444`),图片宽度不超过页宽。包装器还会查看你的文字,把文档语言设为英文、简体或繁体中文、日文、韩文、阿拉伯文、泰文或印地文,阿拉伯文会按从右到左排版。
对于 ZIP,转换器只渲染一个 Markdown 文件:压缩包根目录有 `index.md` 就用它,否则用遍历文件夹时找到的第一个 `.md`。生成的 HTML 保存在解压文件夹的根目录,所以 Markdown 里的图片路径是相对于这个根目录解析的,不是相对于 `.md` 所在的子文件夹。
输出以你的上传文件命名,所以 `release-notes.md` 返回 `release-notes.pdf`。
功能
- CommonMark(`pulldown_cmark`)再交给 WeasyPrint
- 带 CJK 的 HTML 包装;不是 Pandoc
- 网站接受 `.md`;接口也允许 ZIP
- 匿名 API:/api/v1/convert/markdown/pdf
适用场景
- 把 README 或规格说明印成 PDF
- 把 OCR 的 Markdown 变成可打印的 PDF
- 把 CommonMark 笔记作为分页文件分享
- 把带任务列表和表格的会议记录归档成固定的文档
- 把 CJK 或阿拉伯文笔记交给不用 Markdown 工具的人
如何把 Markdown 转成 PDF?
- 上传 UTF-8 的 `.md` 文件。
- 点击处理。本页没有主题或纸张字段。
- 下载 PDF。
- 检查标题、列表和 CJK 字形。复杂的 HTML 嵌入可能无法打印。
- 如果图片缺失,请改用 API,发送一个含 `index.md` 和图片文件的 ZIP,路径相对于压缩包根目录。
- 如果你需要不同的外观(纸张尺寸、字体、颜色),请自己转成 HTML,加上你自己的 CSS,改用 HTML 转 PDF;本页没有样式选项。
限制与边界
- 没有 Pandoc 过滤器,没有 JS,没有主题选择器
- 虽然 API 允许,网站选择器不开放 ZIP
- 必须是 UTF-8 的 Markdown
- 一个 ZIP 只渲染一个 Markdown 文件
- 页面尺寸、页边距和字体由内置样式表固定
- 本网站的上传上限:每个文件 500 MB,超过约 95 MB 时分块上传。直接调用 API 时,单个请求体上限为 100 MB。
示例
- UTF-8 的 Markdown 标题和列表通常会变成带这些样式的短 PDF
- 改名为 .md 的 .txt 可能通过扩展名检查,但仍需要有效的 UTF-8
- 带管道表格和 `- [x]` 任务列表的 `notes.md` 会打印出表格和已勾选的项目,因为这两个扩展都已启用
- 写成 `[^1]` 的脚注不会被解析器选项转换,所以它应该以字面文本出现;请改用行内注释
本工具的隐私说明
文件经 HTTPS 上传,在服务器内存或短期临时目录中处理,结果就绪后即删除。我们不会为日后浏览、训练或广告画像保留副本。留存期限与 AdSense Cookie 说明见隐私政策。
常见问题
- 会运行 Mermaid 或 JS 小部件吗?
- 不会。WeasyPrint 打印的是 CommonMark 生成的 HTML。脚本不会运行。
- 为什么我的文件被拒绝了?
- 名字必须以 .md 或 .zip 结尾。其他扩展名会被当作不支持的文件类型而拒绝。
- 能把 OCR 的 Markdown 发到这里吗?
- 可以,只要它是 .md 文件。这是本站 OCR 为数不多的有用衔接之一。
- 完全支持 GitHub Flavored Markdown 吗?
- 部分支持。在 CommonMark 之上启用了表格、删除线和任务列表;脚注和 emoji 短代码不支持。
- PDF 用什么页面尺寸和页边距?
- A4,页边距 2 cm,正文 11 pt。这些是固定的;本页没有字段可以更改。
- 中文、日文、韩文或阿拉伯文能用吗?
- 包装器会检测主要文字并设置文档语言,字体栈列出了 CJK、阿拉伯文、泰文和天城文字体族。字形能不能打印出来,仍取决于服务器上是否安装了相配的字体,所以请检查输出里有没有空方框。
- 怎么放入图片?
- 通过 API 发送 ZIP,里面放 Markdown 文件和图片,并用相对于压缩包根目录的相对路径引用它们。网页选择器只列出 .md 文件。
- 如果我的 ZIP 里有多个 Markdown 文件,用哪一个?
- 只用一个:根目录有 index.md 就用它,否则用搜索文件夹时找到的第一个 .md。要打印多个文件,请先把它们合并成一个 Markdown 文件。
- 哪个错误表示上传的不是有效文本?
- 不是有效 UTF-8 的普通 .md 上传,会被拒绝,消息说 Markdown 文件不是有效的 UTF-8 文本。请把文件另存为 UTF-8 后再试。
最后更新:
用代码调用
本站每个工具都是普通 REST 接口。匿名使用不需要账号或 API Key,给浏览器、开发者和智能体同样可用。
curl -X POST "https://pdf123.xyz/api/v1/convert/markdown/pdf" \
-F "[email protected]" \
-o output.pdf也提供 MCP 工具,供说 Model Context Protocol 的客户端调用(JSON-RPC 2.0,POST /mcp)。 完整 API 文档
在 AI 代理中使用
Skill装上这个 Skill,Claude Code、Codex、Cursor 等 AI 代理就能替你完成「Markdown 转 PDF」: /skills/pdf123-markdown-to-pdf.md
文件只用于本次处理,完成后自动删除。