Skip to content

Configure PDF output

Customize the appearance of generated PDFs with branding, fonts, and page headers and footers.

PDF branding settings

Go to Settings > Branding to configure:

Primary color: Applied to headings and decorative elements in the PDF.

Logo: Displayed on the PDF cover page.

Font family: Choose a separate font for PDF output. Serif fonts tend to work better in print than on screen.

Header text: Custom text that appears at the top of every page — e.g., your company name or document classification ("Confidential").

Footer text: Custom text at the bottom of every page — e.g., "© 2024 Acme Inc." or a document ID.

PDF rendering uses a separate CSS pipeline from web output. Styles that work on your published web site may not carry over to PDFs. Custom CSS entered in Settings > Branding applies only to web targets — PDF output uses the branding fields above.

PDF structure

Generated PDFs include:

  1. Cover page — project name, target name, generation date, logo

  2. Table of contents — generated from the map structure with page numbers

  3. Topic content — one page per topic with print-ready typography

  4. Page breaks — automatic between topics

If you need finer control over PDF layout, these CSS properties affect print rendering:

/* Force a page break before every H1 */
h1 {
  page-break-before: always;
}

/* Prevent headings from appearing at the bottom of a page
   without any following content */
h2, h3 {
  page-break-after: avoid;
}

/* Keep images from being split across pages */
img {
  page-break-inside: avoid;
}

/* Adjust margins for the printed page */
@page {
  margin: 1in 0.75in;
}

Choose a serif font for a more traditional print look. Serif typefaces are generally easier to read in long-form printed documents because the serifs guide the eye along lines of text.

Tips

  • Keep header and footer text short — long text may overflow on narrow pages.

  • The primary color should have enough contrast against white for readability in print.

  • Test PDF output before distributing — publish a PDF target and review the downloaded file.

See also

Was this page helpful?