본문으로 건너뛰기
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 압축을 거치지 않으므로, 다운로드는 단순 재압축이 아니라 진짜 선형화 출력입니다.

선형화하면 보통 파일이 약간 커집니다. 다운로드가 끝나기 전에 뷰어가 1페이지를 보여 줄 수 있도록 하는 테이블이 추가되기 때문입니다. 이미지를 축소하거나 객체를 버리지는 않습니다. 크기를 줄이는 것이 목적이라면 PDF 압축을 사용하세요.

결과는 `qpdf --check`로 확인할 수 있습니다. 선형화된 파일은 `File is linearized`를 출력합니다. 비밀번호로 보호된 파일은 이 페이지에서 비밀번호를 입력하면 자동으로 해제됩니다. API 호출자는 먼저 비밀번호 해제를 실행하세요.

기능

  • qpdf `--linearize` — Fast Web View
  • 선형화 사전과 페이지 힌트 표 기록
  • 이미지를 축소하지 않고 페이지 내용도 바꾸지 않음
  • 익명 API: /api/v1/misc/linearize-pdf

이런 경우에

  • 큰 PDF를 브라우저에서 페이지 단위로 제공
  • 스캔한 보고서를 긴 빈 화면 없이 웹 뷰어로 전달
  • 포털의 '웹에 최적화' 업로드 요건 충족

PDF를 선형화해 웹 보기를 빠르게 하려면?

  1. PDF를 업로드합니다.
  2. 처리를 클릭합니다. 옵션은 없습니다.
  3. 선형화된 PDF를 내려받습니다.
  4. `File is linearized` 줄을 직접 확인하려면 `qpdf --check`를 실행하세요.

제한과 경계

  • 파일을 재구성하는 도구이며 용량 축소 도구가 아님
  • 이미지를 다시 샘플링하지 않음
  • 비밀번호로 보호된 파일은 비밀번호가 필요(API는 먼저 비밀번호 해제 실행)
  • 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.

예시

  • 40MB 스캔 파일은 40MB보다 약간 커지지만 1페이지가 즉시 렌더링되기 시작합니다
  • 내려받은 파일에 `qpdf --check`를 실행하면 `File is linearized`가 출력됩니다

이 도구의 개인정보 안내

파일은 HTTPS로 업로드되며, 서버 메모리 또는 수명이 짧은 임시 디렉터리에서 처리되고, 결과가 준비되면 삭제됩니다. 이후 열람·학습·광고 프로필용 사본은 보관하지 않습니다. 보관 기간과 AdSense 쿠키 고지는 개인정보 처리방침을 참고하세요.

자주 묻는 질문

결과가 선형화되었나요?
예. 이 연산은 qpdf에 `--linearize`를 전달하므로 출력에 선형화 사전과 페이지 힌트 표가 포함됩니다.
PDF 압축과 어떻게 다른가요?
PDF 압축은 용량을 줄이려고 스트림을 다시 압축합니다. 선형화는 점진적 다운로드를 위해 파일을 재배열하고 내용은 그대로 둡니다.
웹 뷰어가 1페이지를 먼저 불러오나요?
그것이 Fast Web View의 목적입니다. 다만 뷰어가 HTTP로 파일을 가져오고 서버가 바이트 범위 요청을 지원해야 합니다.
이미지를 축소하나요?
아니요. 선형화는 구조를 다시 쓰는 것이지 화질을 낮추는 것이 아닙니다.

최종 업데이트:

코드에서 호출하기

이 사이트의 도구는 모두 일반 REST 엔드포인트입니다. 익명 사용에는 계정이나 API 키가 필요 없습니다. 브라우저뿐 아니라 개발자와 AI 에이전트도 그대로 쓸 수 있습니다.

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

Model Context Protocol을 쓰는 에이전트 클라이언트용 MCP 도구로도 제공합니다(JSON-RPC 2.0, POST /mcp). 전체 API 문서

AI 에이전트에서 사용하기

스킬

이 스킬을 설치하면 Claude Code, Codex, Cursor 등 AI 에이전트가 'PDF 선형화' 작업을 대신 실행합니다: /skills/pdf123-linearize-pdf.md

전체 에이전트 스킬

파일은 이번 처리에만 쓰이며, 끝나면 자동으로 삭제됩니다.