PDF table of contents generator — create bookmarks automatically

Printed TOC vs PDF bookmarks — they are not the same thing

The single most common confusion in this area is treating "table of contents" and "bookmarks" as synonyms. They are independent structures with different storage, visibility, and uses.

In the ISO 32000-1 PDF specification, the outline is defined separately from page content in §12.3.3 (Document outline).¹ It is a tree of outline items, each pointing to a destination — typically a specific page and a target location within that page. The viewer renders the tree in the sidebar and handles the click-to-jump behaviour. None of that has anything to do with what is visible on any given page.

Why PDF bookmarks matter, even for short documents

1. Navigation. Anything longer than ten pages is hard to navigate without bookmarks. The viewer sidebar gives the reader the document's structure at a glance and lets them jump to any section with one click — a dramatically better reading experience than scrolling through the printed TOC, memorising a page number, and pressing Page Down repeatedly.
2. Accessibility. Screen readers expose the outline as the primary navigation structure for users who cannot scan the page visually. A 100-page PDF with no outline is essentially unreadable for a blind user — they can only step through it one page (or one line) at a time. PDF/UA-1 (ISO 14289-1) and WCAG 2.1 both treat document outline as a foundational accessibility requirement.²
3. Search-engine indexing. Google and Bing both extract and use the PDF outline as a document-structure signal when indexing PDF content for search. A well-structured PDF is more likely to be ranked accurately for the section a query maps to, and the outline can show up directly in search results as a jump-to-section table.
4. Programmatic processing. Tools that operate on PDF structure (legal e-discovery platforms, archival systems, document-management software) use the outline as a primary unit of segmentation. A bookmarked PDF can be split by section, re-indexed, or summarised in ways a flat PDF cannot.

Four ways to add bookmarks to an existing PDF

Method 1 — Auto-detect from headings

By far the fastest method, and the right default for any PDF exported from a word processor. The tool reads the PDF and looks for runs of text styled like headings — larger font size, bold or semi-bold weight, consistent spacing above and below. It builds an outline tree by inferring Heading 1 / Heading 2 / Heading 3 from the relative font sizes. Use ScoutMyTool's auto-detect tool on any Word-or-Google-Docs-style PDF and you usually get the right outline in one shot.

Method 2 — Pattern-based

For documents where headings follow a strict text pattern but no font-size cue — legal codes ("§ 12-3"), product manuals ("Chapter 4"), academic appendices ("Appendix B.2") — pattern-based detection lets you specify a regex or a simple wildcard and the tool finds every match across the document, creating a bookmark for each. This works on PDFs without proper heading styles as long as the text pattern is consistent.

Method 3 — CSV-driven

For PDFs whose structure you know but the document does not — typically scanned books, photographed materials, or documents whose headings are inconsistently styled — list the bookmarks in a CSV file: one row per bookmark, columns for level, title, and target page. Feed the CSV to Add Bookmarks from CSV, and the tool builds the outline from your spreadsheet. This is the right method when no heuristic can detect the structure but you can list it out yourself.

Method 4 — Manual entry

For short documents with only a handful of bookmarks (a 10-page proposal with three sections, for example), it is faster to click Add bookmark at each target page than to set up any of the above. Use Add Bookmarks (manual) for these. Beyond ten bookmarks, switch to one of the automated methods.

A worked example — auto-detect on a 100-page handbook

1. Open ScoutMyTool's Table of Contents generator or the auto-detect-from-headings variant in your browser. The tool runs entirely in your browser tab.
2. Drop the PDF into the drop zone. The tool reads the file using the open-source pdf-lib library and the underlying ISO 32000-1 content-stream parser.
3. The tool produces a preview of the detected outline. Review the levels — top-level headings should be "Chapter 1, Chapter 2…" or "Part I, Part II…", and second-level should be the sub-sections within each. Edit titles inline if the heuristic over- or under-classified anything.
4. Click Save bookmarks. The tool writes the outline into the PDF outline dictionary and the page-content streams are not touched. Download the updated PDF.
5. Open the saved PDF in Adobe Reader, Apple Preview, Chrome, or Edge. Open the sidebar — the bookmark tree should match the preview. Click any bookmark to verify the jump-to-page behaviour.

Two related flows worth knowing

Splitting a long PDF by bookmark

Once a PDF has a proper outline, the cleanest way to break it into per-chapter files is Split by Bookmarks — the tool produces one output PDF per top-level bookmark, named after the bookmark title. This is dramatically better than splitting by page range when you do not know the exact page breaks ahead of time.

Extracting an existing bookmark structure

Extract Bookmarks reads a bookmarked PDF and outputs the outline as a CSV or JSON file. Useful for inspecting a counterparty's PDF, for migrating structure from an old PDF to a regenerated version, or for piping the bookmark titles into a search index.

Related ScoutMyTool tools and articles

• PDF Table of Contents generator — the primary tool referenced.
• Auto TOC from headings — automated method 1.
• Bookmarks from pattern — method 2.
• Bookmarks from CSV — method 3.
• Manual bookmark editor — method 4.
• Split by bookmarks — the natural follow-on for chapter-export workflows.
• Extract bookmarks — outline → CSV / JSON.
• Add page numbers, headers and footers — sister article on PDF overlays.

Frequently asked questions

What is the difference between a PDF table of contents and PDF bookmarks?

A printed table of contents is a page near the front of the document that lists section titles and page numbers as ordinary text. PDF bookmarks (formally "outlines" in the ISO 32000-1 specification) are a separate structure stored in the document outline dictionary that PDF viewers display as a clickable tree in the sidebar. The two are independent — a PDF can have one, the other, both, or neither. Most professionally produced PDFs have both: the printed TOC is for print readers, and the bookmark outline is for on-screen readers and accessibility tools.

Will my PDF automatically have bookmarks if I "Save as PDF" from Word?

Only if you used heading styles in the source document. Word's built-in PDF exporter (and Google Docs', LibreOffice's, and InDesign's) reads the heading metadata — Heading 1, Heading 2, Heading 3 — and converts it into a PDF outline tree. If your document is plain text with bold lines instead of proper heading styles, no outline is generated. The fastest fix on an already-exported PDF is to use an auto-detect-from-headings tool that infers the structure from font size and weight on the page.

Is a PDF outline required for accessibility compliance?

For most accessibility standards, yes. PDF/UA-1 (ISO 14289-1) and WCAG 2.1 both require a logical document structure exposed to assistive technologies. A document outline is the primary navigational structure a screen reader uses to let blind and low-vision users jump between sections; without one, the only way to navigate a long PDF is page-by-page, which is impractical. Section 508 of the US Rehabilitation Act, which mandates accessibility for federal agencies and most federal contractors, similarly requires document structure including the outline.

How do I add bookmarks to a scanned PDF that has no text layer?

Two options. The faster option: use a CSV-driven tool where you list each bookmark title and its target page in a spreadsheet, save as CSV, and feed it to the bookmark tool. The slower-but-cleaner option: run OCR on the scan first (so you have a text layer), then use auto-detect-from-headings or pattern-based detection. CSV-driven works for documents where you already know the structure; OCR-then-auto works when you have a long scan you have not read carefully.

Will adding bookmarks change the visible content of the PDF?

No. The outline is stored in a separate dictionary in the PDF file structure and is rendered by the viewer in the sidebar — the visible page content is untouched. If you want a visible printed table of contents on a page as well, that has to be added separately, either by editing the source document and re-exporting or by inserting a TOC page with a tool like Merge PDF.

Can I split a long PDF into one file per bookmark?

Yes. ScoutMyTool's Split by Bookmarks tool takes a bookmarked PDF and produces one output file per top-level bookmark, named after the bookmark title. This is useful for academic papers within an edited volume, chapters of a book, or sections of a manual that need to be distributed separately.

How deep can the bookmark tree go?

The PDF specification places no hard limit on outline nesting depth, but most viewers render up to six or seven levels comfortably. Beyond that, the sidebar becomes hard to navigate. As a practical rule, mirror the heading hierarchy of your source document — for most documents that is three levels (Heading 1 / Heading 2 / Heading 3), and for technical manuals occasionally four. Deeper nesting suggests the document needs restructuring rather than more bookmarks.