跳到主要内容
PPDF123

把 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?

  1. 上传 HTML 文件或含 HTML 的 ZIP。
  2. 不用管 zoom;它不会改变渲染。
  3. 点击处理,下载 PDF。
  4. 检查字体和分页。只靠 JS 的页面会看起来是空的或坏的。
  5. 如果缺了样式表或图片,把它和 HTML 一起放进 ZIP,并用相对路径引用,或者指向公共网址。你自己电脑上的本地文件路径,服务器是用不了的。
  6. 如果分页落在别扭的位置,请在源文件里加上 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

全部 Agent Skill

文件只用于本次处理,完成后自动删除。