跳至主要內容
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 起步。

如果來源已經是 URL,請用網址轉 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. 如果缺少樣式表或圖片,請把它放進 ZIP 中與 HTML 同一層,並用相對路徑引用,或指向公開網址。你自己電腦上的本機檔案路徑,伺服器是讀不到的。
  6. 如果分頁落在尷尬的位置,請在來源中加入 CSS 分頁規則,再算繪一次;轉換器本身沒有版面設定可以調整。

限制與邊界

  • 沒有 JavaScript,沒有 Chrome,沒有縮放
  • 只支援 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,給瀏覽器、開發者與 AI 代理同樣可用。

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

檔案只用於本次處理,完成後自動刪除。