跳至主要內容
PPDF123

線性化 PDF,加快網頁檢視

線性化 PDF 把檔案重寫成線性化結構(也叫快速網頁檢視),檢視器不必等整份檔案下載完就能顯示第一頁。它通常會讓檔案略微變大,而不是變小。

把檔案拖到這裡,或點一下選擇

支援 PDF · 每個檔案上限 500.0 MB · 一次最多 20 個檔案

也可以按 Ctrl/Cmd+V 或從剪貼簿選單貼上檔案。

線性化 PDF 會用 qpdf `--linearize` 重寫檔案,寫入線性化字典與頁面提示表,讓網頁檢視器在整份文件傳完之前就能先繪製第一頁,也就是 Fast Web View(快速網頁檢視)。

這是 `/api/v1/misc/linearize-pdf` 上的獨立操作。它不再經過壓縮 PDF,因此下載的是真正的線性化輸出,而不是單純的重新壓縮。

線性化通常會讓檔案略微變大,因為它要加入一些表,好讓檢視器在下載完成前就能顯示第 1 頁。它不會對圖片降採樣,也不會丟棄物件。如果你的目標是縮小體積,請改用壓縮 PDF。

用 `qpdf --check` 確認結果:線性化檔案會印出 `File is linearized`。有密碼保護的檔案,在你輸入密碼後會在本頁為你解鎖;API 呼叫端需先執行移除密碼。

在本機伺服器上的實測:一份 51,844 位元組、4 頁的文字 PDF,傳回時是 53,701 位元組,大了約 3.6%。`qpdf --check` 對輸入檔印出 `File is not linearized`,對結果則印出 `File is linearized`。一份 4 頁、只有圖片的 PDF 從 11,407 增加到 12,272 位元組,一份 12 頁的試算表匯出檔則從 626,126 增加到 639,658 位元組。增加幾個百分點是正常的結果,不代表出了問題。

這個操作只接受檔案,沒有任何欄位。對已經線性化的檔案再執行一次,在測試中傳回的檔案大小相同(53,701 位元組),所以再跑第二次無害,但也沒有意義。加入密碼的輸出同樣是用 `qpdf --linearize` 寫出的,所以經過加入密碼處理的檔案已經是線性化的,不需要這個步驟。

請先判斷你到底需不需要它。當 PDF 發布在網頁上或透過連結提供,且檢視器能分段取得時,線性化會有幫助。對於以電子郵件附件或入口網站上傳方式傳送、完整下載後才開啟的檔案,它毫無作用。如果目標是更小的檔案,請用壓縮 PDF;如果檔案無法正常開啟,請先試試修復 PDF。

功能

  • qpdf `--linearize`:Fast Web View(快速網頁檢視)
  • 輸出的頁面、文字、字型與圖片都相同;只有檔案內物件的順序改變
  • 已經線性化的檔案傳回時大小相同
  • 不需要任何設定:操作只讀取上傳的檔案
  • 寫入線性化字典與頁面提示表
  • 不對圖片降採樣,也不更動頁面內容
  • 匿名 API:/api/v1/misc/linearize-pdf

適用情境

  • 在瀏覽器中逐頁提供大型 PDF
  • 把掃描報告交給網頁檢視器,不必長時間空白等待
  • 符合入口網站「針對網頁最佳化」的上傳要求
  • 在把長篇型錄或手冊連結到網頁之前先準備好,讓只想看第 1 頁的讀者不用等整份檔案
  • 在託管之前,把來自不同匯出工具的一批 PDF 統一格式,讓每個檔案在磁碟上的結構都相同

如何線性化 PDF 以便快速網頁檢視?

  1. 上傳你要為 Fast Web View 準備的 PDF。
  2. 點選處理。沒有任何選項。
  3. 下載線性化後的 PDF。
  4. 想親自看到 `File is linearized` 那一行,可以執行 `qpdf --check`。
  5. 比較兩個檔案的大小。結果比原檔大幾個百分點是預期中的;結果較小或相等也沒問題。
  6. 如果上傳時被拒絕,原因是 PDF 已損壞,請對原始檔執行修復 PDF,再把修復後的副本線性化。

限制與邊界

  • 重新組織檔案;不是縮小體積的工具
  • 不重新取樣圖片
  • 有密碼保護的檔案需要密碼;API 呼叫端需先執行移除密碼
  • qpdf 無法讀取的檔案會被當成無效而拒絕;請先試試修復 PDF
  • 檢視器是否真的提早顯示第一頁,取決於檢視器以及網頁伺服器是否支援範圍請求,這是本工具無法控制的
  • 不會編輯頁面內容、字型、書籤和表單欄位;只有檔案的配置會改變
  • 本網站的上傳上限:每個檔案 500 MB,超過約 95 MB 時分塊上傳。直接呼叫 API 時,單一請求本文上限為 100 MB。

示例

  • 一份 40 MB 的掃描檔大小仍約為 40 MB,但會立即從第 1 頁開始繪製
  • 對下載檔案執行 `qpdf --check` 會印出 `File is linearized`
  • 一份 51,844 位元組、4 頁的文字 PDF 傳回時是 53,701 位元組,`qpdf --check` 的結果從 `File is not linearized` 變成 `File is linearized`
  • 一份 626,126 位元組、12 頁的試算表匯出檔,傳回時是 639,658 位元組:同樣的 12 頁只增加了 2%
  • 上傳改名為 .pdf 的純文字檔,會傳回 400 與 `invalid_pdf`,而不是檔案

本工具的隱私說明

檔案經 HTTPS 上傳,在伺服器記憶體或短期暫存目錄中處理,結果就緒後即刪除。我們不會為日後瀏覽、訓練或廣告輪廓保留副本。留存期限與 AdSense Cookie 說明見隱私權政策。

常見問題

結果是線性化的嗎?
是。此操作會把 `--linearize` 傳給 qpdf,因此輸出帶有線性化字典與頁面提示表。
它和壓縮 PDF 有何不同?
壓縮 PDF 會重新壓縮串流以節省空間;線性化只是為漸進式下載重排檔案,內容維持原樣。
網頁檢視器會先載入第 1 頁嗎?
這正是 Fast Web View 的重點,前提是檢視器透過 HTTP 取得檔案,且伺服器支援位元組範圍請求。
會對圖片降採樣嗎?
不會。線性化是結構性重寫,不是降低畫質。
為什麼線性化後的檔案比我上傳的還大?
線性化會加入提示表和線性化字典,讓檢視器不必讀完整個檔案就能找到第一頁,而且不會移除任何東西來抵銷。一份 51,844 位元組的測試 PDF 變成了 53,701 位元組。要縮小 PDF,請用壓縮 PDF。
怎麼知道 PDF 是否已經線性化?
執行 `qpdf --check file.pdf`。線性化的檔案會印出 `File is linearized`,否則會印出 `File is not linearized`。檢視器的文件屬性面板也可能顯示 Fast Web View 欄位,不同的應用程式可能有差異。
同一個檔案線性化兩次會怎樣?
沒有任何用處。把已線性化的測試檔再送一次,傳回的大小相同,仍是 53,701 位元組,而且 `qpdf --check` 仍回報它是線性化的。
遇到加密或損壞的檔案會出現什麼錯誤?
加密的檔案會以 HTTP 400 和原因 `password_required` 被拒絕;網頁會要求輸入密碼,API 呼叫端則需先執行移除密碼。不是可讀取的 PDF 的檔案,會以 400 與 `invalid_pdf` 被拒絕,提示會建議使用修復 PDF。
加入密碼也會讓檔案線性化嗎?
會。密碼操作同樣用 qpdf `--linearize` 寫出輸出,所以保護檔案時就已經得到線性化的副本。單獨的線性化是給沒有密碼的檔案使用的。

最後更新:

用程式碼呼叫

本站每個工具都是普通 REST 介面。匿名使用不需要帳號或 API Key,給瀏覽器、開發者與 AI 代理同樣可用。

curl -X POST "https://pdf123.xyz/api/v1/misc/linearize-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 代理就能替你完成「線性化 PDF」: /skills/pdf123-linearize-pdf.md

全部 Agent Skill

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