线性化 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 以便快速网页查看?
- 上传你要为 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 的纯文本文件,返回的是带 `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
文件只用于本次处理,完成后自动删除。