Guides¶
Each guide covers one task, with documents and commands you can run. The examples use the command line; the same options exist in Rust and Python under the names given in the CLI reference.
- Pages and page setup:
@pagesize and margins, named pages, headers and footers in margin boxes, page numbers, page breaks. - Fonts: system fonts, font folders,
@font-face, fallback, complex scripts and right-to-left text. - Images and SVG: raster formats, sizing and
object-fit, inline and external SVG. - Links, bookmarks and the outline: internal and external links, bookmarks and the PDF outline.
- Footnotes and paged-media features: footnotes, running headers, strings, cross-references and tables of contents.
- PDF output: metadata, attachments, PDF versions, PDF/A, PDF/UA and tagged PDF, page ranges, reproducible output.
- Resource loading and security: network off by default, URL patterns, the root directory, limits, custom fetchers.
- Diagnostics, logging and strict mode: what a call reports, how it is printed and logged, and how to fail on it.
- Performance: engine reuse, threads, laying out once and writing several times, the worker process.