Task-oriented guides: each page shows how to use one slice of the canonical API, with copy-pasteable snippets verified against the current release.
| Recipe | Covers |
|---|---|
| charts.md | Native vector bar / line / area / pie-donut charts: data–spec–style layers, axis & grid toggles, point markers, value-label halos, legend placement, translucent area fills |
| rich-text.md | RichText mixed-style runs in one paragraph: bold/accent/styled segments, inline links, inline images, inline SVG icons, emoji shortcodes, inline shapes and checkboxes |
| lists.md | addList: quick bulleted lists, marker customisation, nested lists with per-depth markers, spacing and styled items |
| timelines.md | addTimeline: markers (dot / circle / numbered / square) on a connector rail, geometry and text-style controls, pagination opt-ins |
| keep-together.md | keepTogether() / keepEntriesTogether() — blocks that relocate whole instead of orphaning a heading at a page break |
| shapes.md | Filled cards, dividers, accent bars, lines, spacers, ellipses, images |
| shape-as-container.md | Circles/ellipses/rounded cards holding clipped children, ClipPolicy |
| absolute-placement.md | CanvasLayerNode — children at explicit (x, y) |
| layered-page-design.md | Page background vs. row vs. layer stack vs. canvas — choosing the layer |
| page-backgrounds.md | Per-page fills: sidebars, bands, layered tints |
| transforms.md | Rotation, scaling, skewing |
| tables.md | Tabular layouts: columns, headers, zebra rows, composed cells |
| themes.md | BusinessTheme presets and custom palettes |
| barcodes.md | QR / Code 128 / Code 39 / EAN / UPC / PDF417 / DataMatrix, tinting, quiet zone, card centring |
| images.md | Sources (bytes/path), sizing precedence, STRETCH/CONTAIN/COVER fit modes, images in rows and cards |
| pdf-chrome.md | Metadata, watermarks, running header/footer with {page}/{pages}/{date}, protection, links and outline bookmarks |
| in-pdf-navigation.md | Named anchor(...) destinations + internal linkTo(...) links: clickable tables of contents, #heading-style jumps, bidirectional footnotes, inline-graphic links — native PDF GoTo actions |
| translucency.md | DocumentColor.rgba / withOpacity: which primitives honour alpha, byte-identity for opaque colours, layered tints |
| docx-export.md | Semantic DOCX export: 1:1 node mapping, chart/shape-container fallbacks, skipped kinds |
| snapshot-testing.md | Layout-snapshot regression testing in consumer projects, baseline update flow |
| streaming.md | Streaming PDFs to HTTP responses |
| extending.md | Extension patterns: custom nodes via the NodeDefinition SPI |
Every shipped feature now has a recipe; the runnable examples remain the end-to-end references.