책갈피 기준으로 PDF를 장별로 나누기
장별로 분할은 PDF를 최상위 책갈피에서 잘라 장마다 PDF 하나씩을 ZIP으로 돌려줍니다. 페이지의 글이 아니라 개요를 읽으므로 책갈피가 없는 파일은 거절됩니다.
여기에 파일을 끌어다 놓거나, 클릭해 고릅니다
PDF 지원 · 파일당 최대 500.0 MB · 한 번에 최대 20개 파일
Ctrl/Cmd+V 또는 클립보드 메뉴로 파일을 붙여넣을 수도 있습니다.
장별로 분할은 PDF 개요(`/Outlines`의 First/Next)의 최상위 항목을 따라가며 qpdf로 장별 PDF를 만들어 ZIP에 담습니다. 제목을 OCR하지 않으며 페이지에 있는 제목 텍스트도 해석하지 않습니다.
`allowDuplicates`는 적용됩니다. 폼의 `bookmarkLevel`은 무시되고 최상위 개요 레벨만 사용합니다. 개요가 없는 파일은 BadRequest를 반환하며, 첫 책갈피 앞의 페이지는 어떤 장에도 포함되지 않습니다.
ZIP 이름은 `{base}_split.zip`이고 그 안의 파일 이름은 `{base}_chapter_N.pdf`입니다. 비밀번호로 보호된 파일은 이 페이지에서 비밀번호를 입력하면 해제됩니다. API 호출자는 먼저 비밀번호 해제를 실행해야 합니다.
책갈피가 없다면 PDF 분할(페이지 단위로 자르기)이나 페이지 수로 PDF 분할(페이지 수 단위로 나누기)을 대신 쓰세요.
각 장은 그 책갈피가 가리키는 페이지에서 시작해 다음 최상위 책갈피가 가리키는 페이지 직전까지입니다. 마지막 장은 문서의 마지막 페이지까지입니다. 모든 장이 책갈피에서 시작하므로, 첫 책갈피 앞에 있는 것, 예컨대 자체 책갈피가 없는 표지나 목차는 어떤 출력 파일에도 들어가지 않습니다. 그 페이지가 필요하면 PDF 분할이나 페이지 추출로 따로 추출하세요.
책갈피 제목은 읽지만 파일 이름에는 쓰지 않습니다. 출력은 개요 순서대로 `chapter_1`, `chapter_2`처럼 번호가 매겨지므로, 번호를 제목에 대응시켜야 한다면 개요를 따로 적어 두세요. 책갈피의 목적지를 페이지로 해석할 수 없으면 1페이지로 취급되며, 이것이 장이 엉뚱한 곳에서 시작하는 흔한 이유입니다.
최상위 책갈피 아래에 중첩된 장, 예컨대 제1부 아래의 절은 부모 안에 그대로 남습니다. 개요의 최상위가 장이 아니라 부라면 부마다 파일이 하나씩 나옵니다.
기능
- 최상위 `/Outlines`만 사용하며 qpdf로 잘라 ZIP에 담음
- `bookmarkLevel`은 무시되며 개요가 없는 PDF는 오류
- OCR도 제목 텍스트 감지도 아님
- 익명 API: /api/v1/general/split-pdf-by-chapters
이런 경우에
- 제대로 된 개요가 이미 있는 책을 장별 파일로 자르기
- 책갈피가 실제 절과 일치하는 보고서 나누기
- 제목 텍스트로 장의 시작을 짐작하는 일 피하기
- 한 부분만 필요한 학생이나 팀을 위해 교재나 매뉴얼을 별도의 다운로드로 나누기
- 섹션당 문서 하나를 원하는 기록 관리 시스템을 위해 보고서의 각 섹션을 파일 하나씩으로 보관하기
PDF를 장별로 나누려면?
- 이미 개요/책갈피 패널이 있는 PDF를 업로드합니다.
- 처리를 누릅니다. bookmarkLevel은 자르는 위치를 바꾸지 않습니다.
- `{name}_split.zip`을 내려받습니다.
- 압축을 풀어 장의 시작이 인쇄된 제목이 아니라 개요와 일치하는지 확인합니다.
- 먼저 원본의 책갈피 패널을 열어 최상위 항목이 몇 개인지 알아 두세요. 그 수가 받게 될 파일 수입니다.
- 각 장 파일의 첫 페이지를 해당 책갈피와 비교하세요. 장이 엉뚱한 페이지에서 시작한다면 책갈피 자체가 그곳을 가리키고 있는 것입니다.
제한과 경계
- /Outlines가 필요함
- 최상위 레벨만 사용
- OCR 아님
- 첫 책갈피 앞의 페이지는 버려짐
- 출력 파일 이름은 책갈피 제목이 아니라 번호
- 엉뚱한 페이지를 가리키는 책갈피는 엉뚱한 곳을 자름
- 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.
예시
- 1, 25, 80페이지에 최상위 책갈피가 있는 200페이지짜리 책: chapter_1은 1~24페이지, chapter_2는 25~79페이지, chapter_3은 80~200페이지
- 첫 책갈피가 3페이지에 있는 보고서: 1, 2페이지는 어떤 출력 파일에도 들어가지 않음
- 두 책갈피가 모두 40페이지를 가리키는 경우: `allowDuplicates`가 꺼져 있으면 첫 번째를 건너뛰고, 켜져 있으면 빈 장 파일이 생김
- 최상위 책갈피가 10개인 10장짜리 책은 ZIP에 약 10개의 PDF가 담김
- 페이지에 제목은 인쇄되어 있지만 개요 패널이 비어 있는 PDF는 오류
이 도구의 개인정보 안내
파일은 HTTPS로 업로드되며, 서버 메모리 또는 수명이 짧은 임시 디렉터리에서 처리되고, 결과가 준비되면 삭제됩니다. 이후 열람·학습·광고 프로필용 사본은 보관하지 않습니다. 보관 기간과 AdSense 쿠키 고지는 개인정보 처리방침을 참고하세요.
자주 묻는 질문
- 파일이 몇 개 나올지 어떻게 알 수 있나요?
- 책갈피 패널의 최상위 항목 수를 세세요. 연속한 두 책갈피가 같은 페이지를 가리키고 `allowDuplicates`가 꺼져 있는 경우를 빼면 항목마다 파일 하나가 됩니다.
- 표지와 목차 페이지가 빠지는 이유는 무엇인가요?
- 첫 책갈피 앞의 페이지는 어떤 장에도 속하지 않아 어디에도 쓰이지 않습니다. 첫 페이지에 책갈피를 추가하거나 다른 도구로 그 페이지를 추출하세요.
- 장 파일의 길이가 이상한 이유는 무엇인가요?
- 각 장은 다음 최상위 책갈피가 시작하는 곳에서 끝납니다. 책갈피가 엉뚱한 페이지를 가리키거나 개요 순서가 어긋나 있으면 자르는 위치도 그대로 따라갑니다. 원본에서 책갈피를 고친 뒤 다시 실행하세요.
- 파일 이름을 장 제목으로 만들 수 있나요?
- 아니요. 위치 순서에 따라 `{base}_chapter_N.pdf`로 번호가 매겨집니다. 제목이 필요하면 압축을 푼 뒤 이름을 바꾸세요.
- PDF에 하위 절 책갈피만 있다면 어떻게 되나요?
- 최상위만 사용합니다. 모든 항목이 하나의 루트 책갈피 아래에 중첩된 하위 절이라면 그 루트의 전체 범위를 담은 파일 하나가 나옵니다.
- 페이지 번호를 알고 있다면 어떤 도구를 써야 하나요?
- 페이지 번호를 직접 입력하는 PDF 분할을 쓰세요. 개요가 전혀 필요하지 않습니다.
- 제목이 눈에 보이는데도 실패했습니다. 왜 그런가요?
- 이 연산은 페이지의 글자가 아니라 개요 사전을 읽습니다. 먼저 책갈피를 추가하거나 다른 분할 도구를 쓰세요.
- 제목 레벨 2로 나눌 수 있나요?
- 아니요. bookmarkLevel은 쓰이지 않습니다. 최상위 개요 항목들만 자르는 지점이 됩니다.
- PDF 분할과 같은 건가요?
- 아니요. PDF 분할은 입력한 페이지 번호를 사용하고, 이 도구는 개요의 목적지를 사용합니다.
- allowDuplicates는 무슨 일을 하나요?
- 꺼져 있으면 다음 책갈피가 같은 페이지를 가리키는 장은 건너뜁니다. 켜져 있으면 그 장은 빈 PDF가 됩니다.
최종 업데이트:
코드에서 호출하기
이 사이트의 도구는 모두 일반 REST 엔드포인트입니다. 익명 사용에는 계정이나 API 키가 필요 없습니다. 브라우저뿐 아니라 개발자와 AI 에이전트도 그대로 쓸 수 있습니다.
curl -X POST "https://pdf123.xyz/api/v1/general/split-pdf-by-chapters" \
-F "[email protected]" \
-o output.pdfModel Context Protocol을 쓰는 에이전트 클라이언트용 MCP 도구로도 제공합니다(JSON-RPC 2.0, POST /mcp). 전체 API 문서
AI 에이전트에서 사용하기
스킬이 스킬을 설치하면 Claude Code, Codex, Cursor 등 AI 에이전트가 '장별로 분할' 작업을 대신 실행합니다: /skills/pdf123-split-by-chapters.md
파일은 이번 처리에만 쓰이며, 끝나면 자동으로 삭제됩니다.