把 HTML 转成 PDF
HTML 转 PDF 用 WeasyPrint 把上传的 .html 或 .htm 文件,或含 HTML 的 ZIP 渲染成 PDF。JavaScript 不会运行,所以靠脚本生成的页面输出会不完整。
把文件拖到这里,或点击选择
支持 HTML, HTM, ZIP · 单个文件不超过 500.0 MB · 一次最多 20 个文件
也可以按 Ctrl/Cmd+V 或从剪贴板菜单粘贴文件。
HTML 转 PDF 用 WeasyPrint 渲染。上传 `.html` / `.htm` 文件,或至少包含一个 `.html` 的 ZIP(压缩包根目录有 `index.html` 就用它,否则用第一个 `.html` 条目)。结果是以上传文件命名的 PDF。
`zoom` 字段被忽略。没有无头 Chrome,也不执行 JavaScript。外部图片、样式表和字体会从公共网址获取(最多 500 个资源,每个 64 MiB,每个请求 15 秒),指向私有或内部网络的地址会被阻止。ZIP 内的相对资源从解压出的文件里解析。
WeasyPrint 支持的 CSS 都会打印出来。依赖大量脚本的应用、始终下载不下来的网络字体,以及现代 JS 布局,常常会塌掉。加密的 PDF 不是输入;本工具从 HTML 出发。
如果源头已经是网址,用网址转 PDF。如果源头是 Markdown,用 Markdown 转 PDF(先走 CommonMark,再走同样的 WeasyPrint 步骤)。
单个上传会作为一个 HTML 文件写到磁盘上,按原样渲染。周围不会添加任何东西:没有打印样式表,没有页面尺寸,没有字体。页面尺寸和页边距来自你自己的 CSS,例如 `@page` 规则,否则就用 WeasyPrint 的默认值。
在 ZIP 里,没有根目录 `index.html` 时,只考虑名字以 `.html` 结尾的条目;压缩包里的 `.htm` 文件不会被选中。没有这种条目的压缩包会被拒绝,提示 ZIP 必须包含 .html 文件;试图逃出解压文件夹的条目名(例如带 `..`)同样会被拒绝。
PDF 以上传文件命名,所以 `invoice-2041.html` 返回 `invoice-2041.pdf`。渲染默认在 180 秒后被终止,非常大或获取很慢的页面可能碰到这个限制。
功能
- WeasyPrint,不是 Chromium
- 接受 HTML 或 ZIP(渲染 index.html,没有则渲染第一个 .html)
- zoom 忽略;无 JavaScript
- 匿名 API:/api/v1/convert/html/pdf
适用场景
- 把静态的发票 HTML 打印成 PDF
- 渲染不需要 JS 的基于 CSS 的报告
- 把小型的 HTML 加资源 ZIP 变成 PDF
- 把导出的 HTML 邮件或收据归档成固定的文档
- 在发布前检查打印样式表是怎么分页的
如何把 HTML 转成 PDF?
- 上传 HTML 文件或含 HTML 的 ZIP。
- 不用管 zoom;它不会改变渲染。
- 点击处理,下载 PDF。
- 检查字体和分页。只靠 JS 的页面会看起来是空的或坏的。
- 如果缺了样式表或图片,把它和 HTML 一起放进 ZIP,并用相对路径引用,或者指向公共网址。你自己电脑上的本地文件路径,服务器是用不了的。
- 如果分页落在别扭的位置,请在源文件里加上 CSS 分页规则再渲染一次;转换器本身没有可调的版式设置。
限制与边界
- 没有 JavaScript,没有 Chrome,没有 zoom
- 仅支持 WeasyPrint 的 CSS
- 远程资源只能从公共网址加载;私有和内部地址会被阻止
- 渲染默认在 180 秒后停止
- 在 ZIP 里只匹配 `.html` 名字,不匹配 `.htm`
- 不应用默认页面尺寸或页边距;版式来自你的 CSS
- 本网站的上传上限:每个文件 500 MB,超过约 95 MB 时分块上传。直接调用 API 时,单个请求体上限为 100 MB。
示例
- 带本地 CSS 的语义化 HTML 信函,常常能干净地打印
- 没有构建的 create-react-app index.html,通常打印出来是空白
- 含 `index.html`、`style.css` 和 `logo.png` 的 ZIP,渲染 index.html,相对路径的样式表和徽标会在解压出的文件夹里找到
- 含 `pages/a.html` 和 `pages/b.html`、没有 index.html 的 ZIP,只渲染压缩包里第一个 .html 条目,不是两个都渲染
本工具的隐私说明
文件经 HTTPS 上传,在服务器内存或短期临时目录中处理,结果就绪后即删除。我们不会为日后浏览、训练或广告画像保留副本。留存期限与 AdSense Cookie 说明见隐私政策。
常见问题
- 为什么我的 React 应用变成空白 PDF?
- WeasyPrint 不运行 JavaScript。请发送静态 HTML,不要发空的 SPA 外壳。
- zoom 有用吗?
- 没用。转换函数不接受参数。
- ZIP 是怎么处理的?
- 压缩包根目录有 index.html,就渲染它;否则渲染第一个 .html 条目。
- 这是 Chrome 的打印成 PDF 吗?
- 不是。它是 WeasyPrint 的 HTML/CSS 引擎。
- 怎么设置纸张尺寸和页边距?
- 在你 HTML 的 CSS 里,用 @page 规则。本页没有纸张或页边距字段,而且与 Markdown 转 PDF 不同,它不会注入默认样式表,所以你的 CSS 没指定的部分,都由渲染器决定。
- 转换器能加载我电脑上的图片吗?
- 不能用本地路径。请把图片打包进 ZIP 并用相对引用,或者使用公共网址。指向私有或内部网络的地址会被阻止。
- 我的 ZIP 被拒绝了。为什么?
- 要么里面没有以 .html 结尾的文件(压缩包里的 .htm 文件不算),要么有条目名试图离开解压文件夹。请把条目重命名为 .html,并在重新打包时不要带上级目录路径。
- 实时网页该用哪个工具?
- 网址转 PDF 会替你获取公共网址。HTML 转 PDF 用于你已经有成文件的标记。
最后更新:
用代码调用
本站每个工具都是普通 REST 接口。匿名使用不需要账号或 API Key,给浏览器、开发者和智能体同样可用。
curl -X POST "https://pdf123.xyz/api/v1/convert/html/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 代理就能替你完成「HTML 转 PDF」: /skills/pdf123-html-to-pdf.md
文件只用于本次处理,完成后自动删除。