Przejdź do głównej treści
PPDF123

Linearyzacja PDF dla szybkiego podglądu w sieci

Linearyzuj PDF zapisuje plik w układzie zlinearyzowanym, zwanym też szybkim podglądem w sieci (Fast Web View), aby czytnik mógł pokazać pierwszą stronę, zanim cały plik zostanie pobrany. Zwykle powiększa plik nieznacznie, a nie zmniejsza.

Przeciągnij pliki tutaj albo kliknij, żeby wybrać

Obsługiwane: PDF · do 500.0 MB na plik · maks. 20 plików naraz

Możesz też wkleić plik przez Ctrl/Cmd+V lub z menu schowka.

Linearyzuj PDF przepisuje plik za pomocą qpdf `--linearize`, zapisując słownik linearyzacji i tablicę podpowiedzi stron, dzięki czemu czytnik internetowy może narysować pierwszą stronę, zanim dotrze cały dokument — Fast Web View.

To osobna operacja pod `/api/v1/misc/linearize-pdf`. Nie przechodzi już przez Kompresuj PDF, więc pobrany plik jest naprawdę zlinearyzowany, a nie zwykle ponownie skompresowany.

Linearyzacja zwykle nieznacznie powiększa plik, ponieważ dodaje tabele, dzięki którym czytnik może pokazać stronę 1, zanim pobieranie się zakończy. Nie zmniejsza rozdzielczości obrazów ani nie odrzuca obiektów. Jeśli celem jest rozmiar, użyj zamiast tego Kompresuj PDF.

Sprawdź wynik przez `qpdf --check`: plik zlinearyzowany wypisuje `File is linearized`. Pliki chronione hasłem są odblokowywane za Ciebie na tej stronie, gdy tylko wpiszesz hasło; wywołujący API najpierw uruchamiają Usuń hasło.

Zmierzone na lokalnym serwerze: 4-stronicowy PDF tekstowy o rozmiarze 51 844 bajtów wrócił jako 53 701 bajtów, czyli około 3,6% większy. `qpdf --check` wypisał `File is not linearized` dla wejścia i `File is linearized` dla wyniku. 4-stronicowy PDF zawierający tylko obrazy urósł z 11 407 do 12 272 bajtów, a eksport arkusza na 12 stron z 626 126 do 639 658 bajtów. Wzrost o kilka procent to normalny wynik, a nie znak, że coś poszło nie tak.

Operacja przyjmuje tylko plik, bez żadnych pól. Uruchomiona na pliku, który już jest zlinearyzowany, zwróciła w teście plik o tym samym rozmiarze (53 701 bajtów), więc drugi przebieg jest nieszkodliwy, ale bezcelowy. Dodaj hasło też zapisuje wynik przez `qpdf --linearize`, więc plik, który przeszedł przez Dodaj hasło, jest już zlinearyzowany i nie potrzebuje tego kroku.

Zastanów się, czy w ogóle tego potrzebujesz. Linearyzacja pomaga, gdy PDF jest opublikowany na stronie internetowej lub udostępniany z linku, a czytnik może pobierać go zakresami. Nie daje nic plikowi, który wędruje jako załącznik e-maila lub plik przesłany do portalu i jest otwierany po całkowitym pobraniu. Jeśli celem jest mniejszy plik, użyj Kompresuj PDF; jeśli plik nie otwiera się poprawnie, najpierw spróbuj Napraw PDF.

Funkcje

  • qpdf `--linearize` — Fast Web View
  • Wynik ma te same strony, tekst, czcionki i obrazy; zmienia się tylko kolejność obiektów w pliku
  • Plik już zlinearyzowany wraca z tym samym rozmiarem
  • Nie wymaga ustawień: operacja czyta tylko przesłany plik
  • Zapisuje słownik linearyzacji i tablicę podpowiedzi stron
  • Nie zmniejsza rozdzielczości obrazów ani nie zmienia treści stron
  • Anonimowe API: /api/v1/misc/linearize-pdf

Kiedy tego użyć

  • Serwować duży PDF strona po stronie w przeglądarce
  • Przekazać zeskanowany raport do czytnika internetowego bez długiego pustego oczekiwania
  • Spełnić wymóg portalu dotyczący wgrywania plików zoptymalizowanych pod sieć
  • Przygotować długi katalog lub podręcznik przed podlinkowaniem go ze strony, aby czytelnik, który chce tylko strony 1, nie czekał na całość
  • Ujednolicić mieszaną partię plików PDF z różnych narzędzi eksportu przed ich hostowaniem, aby każdy plik miał ten sam układ na dysku

Jak zlinearyzować PDF do szybkiego podglądu w sieci?

  1. Prześlij PDF, który chcesz przygotować do Fast Web View.
  2. Kliknij Przetwórz. Nie ma żadnych opcji.
  3. Pobierz zlinearyzowany PDF.
  4. Uruchom `qpdf --check`, jeśli chcesz sam zobaczyć wiersz `File is linearized`.
  5. Porównaj oba rozmiary plików. Wynik o kilka procent większy od oryginału jest oczekiwany; wynik mniejszy lub równy też jest w porządku.
  6. Jeśli przesłany plik zostanie odrzucony jako uszkodzony PDF, uruchom Napraw PDF na oryginale i zlinearyzuj naprawioną kopię.

Ograniczenia i przypadki brzegowe

  • Porządkuje plik; to nie narzędzie do zmniejszania rozmiaru
  • Bez ponownego próbkowania obrazów
  • Pliki chronione hasłem wymagają hasła; wywołujący API najpierw uruchamiają Usuń hasło
  • Plik, którego qpdf nie potrafi odczytać, jest odrzucany jako nieprawidłowy; Napraw PDF to narzędzie do spróbowania najpierw
  • To, czy czytnik faktycznie pokaże stronę pierwszą wcześniej, zależy od czytnika i od tego, czy serwer WWW obsługuje żądania zakresowe, czego to narzędzie nie kontroluje
  • Zawartość stron, czcionki, zakładki i pola formularzy nie są edytowane; zmienia się tylko układ pliku
  • Limit przesyłania na tej stronie: 500 MB na plik, wysyłane porcjami powyżej około 95 MB. Treść pojedynczego bezpośredniego żądania API jest ograniczona do 100 MB.

Przykłady

  • Skan o rozmiarze 40 MB zostaje około 40 MB, ale od razu zaczyna się renderować od strony 1
  • `qpdf --check` na pobranym pliku wypisuje `File is linearized`
  • 4-stronicowy PDF tekstowy o rozmiarze 51 844 bajtów wraca jako 53 701 bajtów, a `qpdf --check` zmienia się z `File is not linearized` na `File is linearized`
  • Eksport arkusza na 12 stron o rozmiarze 626 126 bajtów wraca jako 639 658 bajtów: wzrost o 2% dla tych samych 12 stron
  • Przesłanie zwykłego pliku tekstowego przemianowanego na .pdf zwraca 400 z `invalid_pdf` zamiast pliku

Prywatność tego narzędzia

Pliki są przesyłane przez HTTPS, przetwarzane w pamięci lub w krótkotrwałym katalogu tymczasowym na naszych serwerach i usuwane, gdy wynik jest gotowy. Nie przechowujemy kopii do późniejszego przeglądania, trenowania ani profili reklamowych. Szczegóły retencji i pliki cookie AdSense znajdują się w polityce prywatności.

Najczęstsze pytania

Czy wynik jest zlinearyzowany?
Tak. Operacja przekazuje `--linearize` do qpdf, więc wynik zawiera słownik linearyzacji i tablice podpowiedzi stron.
Czym różni się to od Kompresuj PDF?
Kompresuj PDF ponownie kompresuje strumienie, żeby zaoszczędzić miejsce. Linearyzuj PDF porządkuje plik pod pobieranie progresywne i zostawia treść bez zmian.
Czy czytniki internetowe najpierw załadują stronę 1?
Właśnie o to chodzi w Fast Web View, pod warunkiem że czytnik pobiera plik przez HTTP, a serwer obsługuje żądania zakresowe bajtów.
Czy zmniejsza rozdzielczość obrazów?
Nie. Linearyzacja to przepisanie struktury, a nie obniżenie jakości.
Dlaczego zlinearyzowany plik jest większy niż ten, który przesłałem?
Linearyzacja dodaje tablicę podpowiedzi i słownik linearyzacji, aby czytnik mógł znaleźć stronę pierwszą bez czytania całego pliku, a nic nie jest usuwane, by za nie zapłacić. Testowy PDF o rozmiarze 51 844 bajtów stał się 53 701 bajtami. Aby zmniejszyć PDF, użyj Kompresuj PDF.
Jak sprawdzić, czy PDF jest już zlinearyzowany?
Uruchom `qpdf --check file.pdf`. Dla pliku zlinearyzowanego wypisuje `File is linearized`, a w przeciwnym razie `File is not linearized`. Panel właściwości dokumentu w czytniku może też pokazywać pole Fast Web View, które bywa różne w zależności od programu.
Co się stanie, jeśli zlinearyzuję ten sam plik dwa razy?
Nic pożytecznego. Zlinearyzowany plik testowy przepuszczony ponownie wrócił z tym samym rozmiarem, 53 701 bajtów, a `qpdf --check` nadal raportował go jako zlinearyzowany.
Jaki błąd dostanę dla pliku zaszyfrowanego lub uszkodzonego?
Plik zaszyfrowany jest odrzucany z HTTP 400 i powodem `password_required`; strona prosi o hasło, a wywołujący API najpierw uruchamiają Usuń hasło. Plik, który nie jest czytelnym PDF, jest odrzucany z 400 i `invalid_pdf`, a podpowiedź sugeruje Napraw PDF.
Czy Dodaj hasło też robi plik zlinearyzowany?
Tak. Operacja z hasłem zapisuje wynik także przez qpdf `--linearize`, więc zabezpieczenie pliku już daje zlinearyzowaną kopię. Samo Linearyzuj PDF służy do plików bez hasła.

Ostatnia aktualizacja:

Wywołanie z kodu

Każde narzędzie na stronie to zwykły interfejs REST. Anonimowo nie trzeba konta ani klucza API. Działa w przeglądarce, u programistów i u agentów AI.

curl -X POST "https://pdf123.xyz/api/v1/misc/linearize-pdf" \
  -F "[email protected]" \
  -o output.pdf

Dostępne też jako narzędzie MCP dla klientów mówiących Model Context Protocol (JSON-RPC 2.0, POST /mcp). Pełna dokumentacja API

Użyj go z agentem AI

Skill

Z tym skillem Claude Code, Codex, Cursor i inne agenty AI mogą wykonać za Ciebie „Linearyzuj PDF”: /skills/pdf123-linearize-pdf.md

Wszystkie skille dla agentów

Pliki służą tylko do tego zadania i są potem automatycznie usuwane.