跳到主要内容
PPDF123

线性化 PDF,加快网页查看

线性化 PDF 把文件重写成线性化结构(也叫快速网页查看),阅读器不必等整份文件下载完就能显示第一页。它通常会让文件略微变大,而不是变小。

把文件拖到这里,或点击选择

支持 PDF · 单个文件不超过 500.0 MB · 一次最多 20 个文件

也可以按 Ctrl/Cmd+V 或从剪贴板菜单粘贴文件。

线性化 PDF 用 qpdf `--linearize` 重写文件,写入线性化字典和页提示表,这样网页阅读器不必等整份文档到齐,就能先绘制第一页,这就是快速网页查看(Fast Web View)。

这是位于 `/api/v1/misc/linearize-pdf` 的独立操作。它不再经过压缩 PDF,所以下载到的是真正线性化的输出,而不是普通的重新压缩。

线性化通常会让文件略微变大,因为它加入了让阅读器在下载完成前就能显示第一页的表。它不会降采样图片,也不会丢弃对象。目标是减小体积的话,请改用压缩 PDF。

用 `qpdf --check` 确认结果:线性化的文件会打印 `File is linearized`。有密码保护的文件,在你输入密码后会在本页为你解锁;API 调用方需先运行移除密码。

在本地服务器上的实测:一份 4 页、51,844 字节的文字 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 的纯文本文件,返回的是带 `invalid_pdf` 的 400,而不是文件

本工具的隐私说明

文件经 HTTPS 上传,在服务器内存或短期临时目录中处理,结果就绪后即删除。我们不会为日后浏览、训练或广告画像保留副本。留存期限与 AdSense Cookie 说明见隐私政策。

常见问题

结果是线性化的吗?
是。该操作给 qpdf 传了 `--linearize`,所以输出带有线性化字典和页提示表。
这和压缩 PDF 有什么不同?
压缩 PDF 重新压缩流以节省空间。线性化为渐进式下载重排文件,内容保持不变。
网页阅读器会先加载第 1 页吗?
这正是快速网页查看的目的,前提是阅读器通过 HTTP 获取文件,且服务器支持字节范围请求。
它会降采样图片吗?
不会。线性化是结构上的重写,不是降低质量。
为什么线性化后的文件比我上传的更大?
线性化加入了提示表和线性化字典,让阅读器无需读完整个文件就能找到第一页,并且没有删除任何东西来抵偿它们。一份 51,844 字节的测试 PDF 变成了 53,701 字节。要缩小 PDF,请用压缩 PDF。
怎么知道 PDF 是否已经线性化?
运行 `qpdf --check file.pdf`。线性化的文件会打印 `File is linearized`,否则打印 `File is not linearized`。阅读器的文档属性面板也可能显示快速网页查看字段,不同应用的显示可能不同。
对同一个文件线性化两次会怎样?
没有任何用处。把已线性化的测试文件再发送一次,回来时大小相同,仍是 53,701 字节,`qpdf --check` 仍报告它是线性化的。
加密或损坏的文件会得到什么错误?
加密文件会被拒绝,返回 HTTP 400 和原因 `password_required`;页面会要求输入密码,API 调用方先运行移除密码。不是可读 PDF 的文件会被拒绝,返回 400 和 `invalid_pdf`,并提示试试修复 PDF。
添加密码也会让文件线性化吗?
会。密码操作同样用 qpdf `--linearize` 写出输出,所以给文件加密码已经能得到线性化的副本。单独的线性化用于没有密码的文件。

最后更新:

用代码调用

本站每个工具都是普通 REST 接口。匿名使用不需要账号或 API Key,给浏览器、开发者和智能体同样可用。

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

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