빠른 웹 보기를 위해 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 압축을 거치지 않으므로, 다운로드는 단순 재압축이 아니라 진짜 선형화된 출력입니다.
선형화하면 보통 파일이 약간 커집니다. 다운로드가 끝나기 전에 뷰어가 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 복구를 시도할 것
- 뷰어가 실제로 1페이지를 일찍 보여 주는지는 뷰어와 범위 요청을 지원하는 웹 서버에 달려 있으며 이 도구가 통제할 수 없음
- 페이지 내용, 글꼴, 책갈피, 양식 필드는 편집되지 않고 파일 배치만 바뀜
- 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.
예시
- 40MB 스캔 파일은 약 40MB 그대로이지만 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 쿠키 고지는 개인정보 처리방침을 참고하세요.
자주 묻는 질문
- 결과가 선형화되었나요?
- 예. 이 연산은 qpdf에 `--linearize`를 전달하므로 출력에 선형화 사전과 페이지 힌트 표가 포함됩니다.
- PDF 압축과 어떻게 다른가요?
- PDF 압축은 용량을 줄이려고 스트림을 다시 압축합니다. 선형화는 점진적 다운로드를 위해 파일을 재배열하고 내용은 그대로 둡니다.
- 웹 뷰어가 1페이지를 먼저 불러오나요?
- 그것이 Fast Web View의 목적입니다. 다만 뷰어가 HTTP로 파일을 가져오고 서버가 바이트 범위 요청을 지원해야 합니다.
- 이미지를 축소하나요?
- 아니요. 선형화는 구조를 다시 쓰는 것이지 화질을 낮추는 것이 아닙니다.
- 선형화한 파일이 업로드한 파일보다 큰 이유는요?
- 선형화는 뷰어가 파일 전체를 읽지 않고 1페이지를 찾을 수 있도록 힌트 표와 선형화 사전을 추가하며, 그 비용을 위해 지워지는 것은 없습니다. 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 키가 필요 없습니다. 브라우저뿐 아니라 개발자와 AI 에이전트도 그대로 쓸 수 있습니다.
curl -X POST "https://pdf123.xyz/api/v1/misc/linearize-pdf" \
-F "[email protected]" \
-o output.pdfModel Context Protocol을 쓰는 에이전트 클라이언트용 MCP 도구로도 제공합니다(JSON-RPC 2.0, POST /mcp). 전체 API 문서
AI 에이전트에서 사용하기
스킬이 스킬을 설치하면 Claude Code, Codex, Cursor 등 AI 에이전트가 'PDF 선형화' 작업을 대신 실행합니다: /skills/pdf123-linearize-pdf.md
파일은 이번 처리에만 쓰이며, 끝나면 자동으로 삭제됩니다.