Print

Printing one page needs no configuration: the shell (sidebar, outline, navbar, buttons) all carries d-print-none, so the browser’s Cmd/Ctrl+P yields a clean body. That is why the theme has no per-page “print this page” button.

What does need configuration is the other thing: assembling a whole section (or a whole book) and all its pages into one continuous document with a table of contents. What follows covers enabling it, the structure of the print view, and how to exclude pages.

Enabling whole-section print

print is a custom output format the theme declares and does not enable for a site. Add it to section in the site’s own hugo.yml:

outputs:
  home: [HTML, markdown, LLMS]
  page: [HTML, markdown]
  section: [HTML, RSS, print, markdown]

That is this site’s configuration. Each key under outputs is a wholesale replacement rather than a merge: adding print means writing back every format that kind already had (HTML, RSS, markdown), and omitting one loses that output.

Once on, every section gains a URL. The _print segment comes first, after the language prefix:

“Print the whole section” also appears in the page action menu, and the same entry is searchable in the command palette (action ID print_section). It prints the current section: clicking it on /docs/customize/print/ produces the entire Customization section, not this one page.

The structure of a print view

Opening any of those links, from top to bottom:

1. A notice bar: “This is the multi-page printable view of this section. Click here to print. Return to the regular view of this page.” It carries d-print-none and appears on screen only, never on paper.
2. The section title and summary.
3. A whole-section table of contents, numbered 1:, 2:, 2.1: by level, linking to in-document anchors.
4. Each page in turn, its title becoming “number - title” as in `1 - Configuration", its description a standfirst, and its body rendered as it stands.

Page order is sidebar order (weight), with subsections expanded recursively. Every page from the second onwards starts a new sheet; whether the first does depends on whether the section index’s own body exceeds 50 words, so an index of one sentence does not take a sheet to itself. The threshold is adjustable:

params:
  print:
    section_break_wordcount: 120

To drop the table of contents:

params:
  print:
    toc: false

It can also be turned off for one section, in the section index’s front matter:

---
title: Components
print:
  toc: false
---

Excluding pages

Link-only pages, pages that are one redirect note, and pages that are one enormous screenshot are not worth paper. Give them no_print:

---
title: Showcase
no_print: true
---

It affects the whole-section print view only; the page’s own HTML and the browser’s Cmd/Ctrl+P are unaffected. Sidebar dividers (sidebar_divider) are excluded automatically.

How components look in print

Print is one of the four outputs, and every component has a defined print shape. The whole-section print view and the browser printing one page follow the same rule: anything interactive degrades to static, and anything collapsible is expanded.

The page shell never reaches paper: sidebar, outline, navbar, the page action menu, the feedback widget, heading anchor links and inline copy buttons.

For the three diagram kinds above that a browser runtime draws (Mermaid, Markmap, PlantUML), confirm they have finished drawing before triggering print.

Browser print styles

The theme ships a layer of @media print rules shared by single-page and whole-section printing:

• A4 paper with 18mm 16mm 20mm margins; 10.5pt body text; the light palette forced.
• Fonts switch to the --td-print-font-family typography token — see Brand and appearance.
• Headings do not separate from their body (break-after: avoid-page), and paragraphs and list items keep three-line orphan and widow control.
• Tables, images, blockquotes, callouts, cards and tabs avoid breaking across pages where possible; code blocks may break, and wrap rather than truncate.
• Links are underlined and turned dark blue, and the URL text is not printed after them. A site that wants that behaviour adds it:

@media print {
  .td-content a[href^='http']::after {
    content: ' (' attr(href) ')';
    font-size: 0.85em;
    word-break: break-all;
  }
}

• A closed <details> is always expanded: collapsed callouts and file tree directories are complete on paper.

Custom print styling goes in a @media print block in assets/scss/_styles_project.scss and needs no template change.

Replacing the print templates

To change the structure — adding a running header, or changing the numbering format — override the narrowest partial. They are all under layouts/_partials/print/:

The last three additionally support per content type: create print/page-heading-blog.html or print/content-book.html and the theme prefers the type-suffixed one.

Printing a whole book (type: book) takes a different path, where chapter numbers, figure numbers and cross-references stay continuous across the book — see Books.

Verify

hugo -d public
ls public/_print/docs/          # one directory per section

Then look at the page:

• Open /_print/docs/customize/ in a browser and confirm the contents has as many rows as the section has pages (minus those with no_print: true).
• Press Cmd/Ctrl+P in that view: the print preview should show no notice bar, no navbar and no buttons.
• Find a page with tabs and a collapsed callout (for example Tabs) and confirm every panel is expanded in the preview.
• Print a PDF and read the pagination through, adjusting section_break_wordcount where the threshold does not suit.

Related

• Books — numbering, indexes and print for a whole book
• Organizing content — print order is sidebar order
• Brand and appearance — the print font token
• AI-agent support — the other non-HTML output
• Configuration — full definitions of outputs and params.print.*