線性化 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 以便快速網頁檢視?
- 上傳你要為 Fast Web View 準備的 PDF。
- 點選處理。沒有任何選項。
- 下載線性化後的 PDF。
- 想親自看到 `File is linearized` 那一行,可以執行 `qpdf --check`。
- 比較兩個檔案的大小。結果比原檔大幾個百分點是預期中的;結果較小或相等也沒問題。
- 如果上傳時被拒絕,原因是 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
檔案只用於本次處理,完成後自動刪除。