Skip to main content
PPDF123

Split a PDF by Chapters

Split by Chapters cuts a PDF at its top-level bookmarks and returns one PDF per chapter in a ZIP. A file with no bookmarks is rejected, because the tool reads the outline, not the page text.

Drag and drop files here, or click to choose

Accepts PDF · up to 500.0 MB per file · up to 20 files at once

You can also paste a file with Ctrl/Cmd+V, or from the clipboard menu.

Split by Chapters walks the PDF outline (`/Outlines` First/Next) at the top level and cuts a ZIP of chapter PDFs with qpdf. It does not OCR titles and it does not parse heading text on the page.

`allowDuplicates` is honored. `bookmarkLevel` on the form is ignored; only the top outline level is used. A file with no outline returns BadRequest, and pages before the first bookmark are not part of any chapter.

The ZIP is named `{base}_split.zip` and holds files named `{base}_chapter_N.pdf`. Password-protected files are unlocked for you on this page once you enter the password; API callers run Unlock first.

If you have no bookmarks, use Split (page cuts) or Split PDF by Page Count (equal-sized chunks) instead.

Each chapter runs from the page its bookmark points to, up to the page where the next top-level bookmark points. The last chapter runs to the final page of the document. Because every chapter starts at a bookmark, anything before the first bookmark, such as a cover or a table of contents that has no bookmark of its own, is left out of every output file. If you need those pages, extract them separately with Split or Extract Pages.

Bookmark titles are read but not used in the file names. Outputs are numbered `chapter_1`, `chapter_2` and so on in outline order, so keep a note of the outline if you need to map numbers back to titles. If a bookmark's destination cannot be resolved to a page, it is treated as page 1, which is a common reason for a chapter that starts in the wrong place.

Chapters nested under a top-level bookmark, such as sections under Part I, stay inside their parent. If the top level of your outline is Parts rather than Chapters, you will get one file per Part.

Features

  • Top-level `/Outlines` only; qpdf cuts into a ZIP
  • `bookmarkLevel` ignored; no-outline PDFs error
  • Not OCR and not heading-text detection
  • Anonymous API at /api/v1/general/split-pdf-by-chapters

When to use this tool

  • Cut a book that already has a proper outline into chapter files
  • Split a report whose bookmarks match real sections
  • Avoid guessing chapter starts from heading text
  • Break a textbook or manual into separate downloads for students or teams who only need one part
  • Archive each report section as its own file for a records system that wants one document per section

How do I split a PDF by chapters?

  1. Upload a PDF that already has an outline/bookmarks panel.
  2. Click Process. bookmarkLevel does not change the cut.
  3. Download `{name}_split.zip`.
  4. Unzip and check that chapter starts match the outline, not the printed headings.
  5. Open the bookmarks panel of the source first so you know how many top-level entries to expect; that count is the number of files you should get.
  6. Compare the first page of each chapter file with its bookmark. A chapter that starts on the wrong page means the bookmark itself points there.

Limits and edge cases

  • Requires /Outlines
  • Top level only
  • Not OCR
  • Pages before the first bookmark are dropped
  • Output names are numbered, not taken from bookmark titles
  • Bookmarks that point to the wrong page cut in the wrong place
  • Upload limit on this website: 500 MB per file, sent in chunks above about 95 MB. A single direct API request body is capped at 100 MB.

Examples

  • A 200-page book with top-level bookmarks at pages 1, 25 and 80: you get chapter_1 with pages 1 to 24, chapter_2 with pages 25 to 79 and chapter_3 with pages 80 to 200
  • A report whose first bookmark is on page 3: pages 1 and 2 are not in any output file
  • Two bookmarks that both point to page 40: with `allowDuplicates` off the first is skipped, with it on you get an empty chapter file
  • A 10-chapter book with 10 top bookmarks yields about 10 PDFs in a ZIP
  • A PDF with printed headings but an empty outline panel errors

Privacy for this tool

Files are uploaded over HTTPS, processed in memory or a short-lived temporary directory on our servers, and deleted when your result is ready. We do not keep copies for later browsing, training, or advertising profiles. See the Privacy Policy for retention details and AdSense cookie disclosures.

Frequently asked questions

How do I know how many files I will get?
Count the top-level entries in the bookmarks panel. Each one becomes a file, unless two consecutive bookmarks point at the same page and `allowDuplicates` is off.
Why are my cover and contents pages missing?
Pages before the first bookmark belong to no chapter and are not written anywhere. Add a bookmark on the first page, or extract those pages with another tool.
Why is a chapter file the wrong length?
Each chapter ends where the next top-level bookmark begins. If a bookmark points to the wrong page, or the outline is out of order, the cuts will follow it. Fix the bookmarks in the source and run again.
Can the files be named after the chapter titles?
No. They are numbered by position, as `{base}_chapter_N.pdf`. Rename them after unzipping if you need titles.
What if my PDF has bookmarks only for sub-sections?
Only the top level is used. If every entry is a sub-section nested under one root bookmark, you will get a single file holding the whole range of that root.
Which tool do I use when I know the page numbers instead?
Use Split with the page numbers typed in. It does not need an outline at all.
My headings are visible but it failed. Why?
The op reads the outline dictionary, not the words on the page. Add bookmarks first, or use another split tool.
Can I split on heading level 2?
No. bookmarkLevel is unused. Only top-level outline siblings are cuts.
Is this the same as Split?
No. Split uses typed page numbers. This uses outline destinations.
What does allowDuplicates do?
With it off, a chapter whose next bookmark points at the same page is skipped. With it on, that chapter becomes an empty PDF.

Last updated:

Call this from code

Every tool on this site is a plain REST endpoint - no account or API key needed for anonymous use. Built for AI agents and developers as much as for browsers.

curl -X POST "https://pdf123.xyz/api/v1/general/split-pdf-by-chapters" \
  -F "[email protected]" \
  -o output.pdf

Also available as an MCP tool for agent clients that speak Model Context Protocol (JSON-RPC 2.0 over POST /mcp). Full API reference

Use it from an AI agent

Skill

Claude Code, Codex, Cursor and other AI agents can run Split PDF by Chapters for you with this skill: /skills/pdf123-split-by-chapters.md

All agent skills

Files are used only for this processing job and deleted automatically afterward.