Перейти к основному содержимому
PPDF123

Линеаризация PDF для быстрого открытия в сети

«Линеаризовать PDF» перезаписывает файл в линеаризованном виде, известном как Fast Web View, чтобы просмотрщик показал первую страницу до полной загрузки файла. Обычно файл становится чуть больше, а не меньше.

Перетащите файлы сюда или нажмите, чтобы выбрать

Форматы: 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-страничный текстовый PDF на 51 844 байта вернулся как 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. Загрузите PDF, который хотите подготовить для Fast Web View.
  2. Нажмите «Обработать». Опций нет.
  3. Скачайте линеаризованный PDF.
  4. Запустите `qpdf --check`, если хотите сами увидеть строку `File is linearized`.
  5. Сравните размеры двух файлов. Результат на несколько процентов больше оригинала — ожидаемо; меньше или равный тоже нормально.
  6. Если загрузка отклонена как повреждённый PDF, запустите «Исправить PDF» на оригинале и линеаризуйте восстановленную копию.

Ограничения и особые случаи

  • Переупорядочивает файл; это не инструмент уменьшения размера
  • Нет пересэмплирования изображений
  • Файлам с защитой паролем нужен пароль; при работе через API сначала запустите «Снять пароль»
  • Файл, который qpdf не может прочитать, отклоняется как недействительный; сначала нужно пробовать «Исправить PDF»
  • Покажет ли просмотрщик страницу 1 заранее, зависит от просмотрщика и от поддержки веб-сервером запросов диапазонов, и этим инструмент управлять не может
  • Содержимое страниц, шрифты, закладки и поля форм не редактируются; меняется только устройство файла
  • Лимит загрузки на сайте: 500 МБ на файл, файлы крупнее примерно 95 МБ отправляются частями. Тело одного прямого запроса к API ограничено 100 МБ.

Примеры

  • Скан на 40 МБ остаётся примерно 40 МБ, но начинает отображаться со страницы 1 сразу
  • `qpdf --check` на скачанном файле выводит `File is linearized`
  • 4-страничный текстовый PDF на 51 844 байта возвращается как 53 701 байт, а `qpdf --check` меняет `File is not linearized` на `File is linearized`
  • Экспорт таблицы на 12 страниц размером 626 126 байт возвращается как 639 658 байт: прирост на 2% для тех же 12 страниц
  • Загрузка простого текстового файла, переименованного в .pdf, возвращает 400 с `invalid_pdf` вместо файла

Конфиденциальность этого инструмента

Файлы загружаются по HTTPS, обрабатываются в памяти или в короткоживущем временном каталоге на наших серверах и удаляются, когда результат готов. Копии для последующего просмотра, обучения моделей или рекламных профилей мы не храним. Сроки хранения и сведения о cookie AdSense указаны в Политике конфиденциальности.

Частые вопросы

Результат линеаризован?
Да. Операция передаёт qpdf `--linearize`, поэтому результат несёт словарь линеаризации и таблицы подсказок страниц.
Чем это отличается от «Сжать PDF»?
«Сжать PDF» пересжимает потоки ради экономии места. «Линеаризовать PDF» переупорядочивает файл для постепенной загрузки и оставляет содержимое как есть.
Будут ли веб-просмотрщики загружать страницу 1 первой?
В этом смысл Fast Web View — при условии, что просмотрщик получает файл по HTTP, а сервер поддерживает запросы диапазонов байт.
Уменьшает ли он изображения?
Нет. Линеаризация — структурная перезапись, а не снижение качества.
Почему линеаризованный файл больше загруженного?
Линеаризация добавляет таблицу подсказок и словарь линеаризации, чтобы просмотрщик нашёл первую страницу, не читая весь файл, и ничего не удаляется ради их оплаты. Тестовый PDF на 51 844 байта стал 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. И для браузера, и для разработчиков, и для ИИ-агентов.

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

Использовать через ИИ-агента

Скилл

С этим скиллом Claude Code, Codex, Cursor и другие ИИ-агенты смогут выполнить «Линеаризовать PDF» за вас: /skills/pdf123-linearize-pdf.md

Все скиллы для агентов

Файлы нужны только для этой обработки и потом удаляются.