Links, bookmarks and contents

A link target starting with # jumps to a named anchor in the same PDF (written as a PDF /Dest GoTo link); anything else is a URL.

text "Docs", link: "https://stationery.zoolutions.llc"
text "Write to <link href='mailto:[email protected]'>[email protected]</link>", markup: true
text { plain "See "; link "#totals", "the totals" }
box(link: "#appendix", padding: 8, background: "#EEF2FF") { text "Appendix" }

box(link:) makes the whole box clickable. Link areas widen with justified text.

text "Introduction", anchor: "intro"      # also box(anchor:), group(anchor:), table(rows, anchor:)
box(anchor: "totals") { text "Totals" }
anchor "appendix"                         # standalone; moves to the next page with what follows it
text "Appendix", size: 16

An anchor on content that splits across pages points at its first page. A link to an unknown anchor is dropped and reported as an UnresolvedLink warning; a name defined twice keeps the first and reports a DuplicateAnchor. Anchors drawn by page templates resolve to the first page.

bookmark: adds an entry to the PDF outline (the viewer's bookmarks sidebar) pointing at where the content paints. Levels nest under the nearest shallower entry above them; open: true shows an entry's children expanded.

text "Introduction", size: 18, bookmark: "Introduction"            # level 1
box(bookmark: { title: "Scope", level: 2, open: true }) { … }      # also group(bookmark:), table(rows, bookmark:)
bookmark "Appendix", level: 1                                       # standalone
text "Appendix", size: 16

A document with bookmarks opens with the outline shown. A bookmark whose content never paints (cut off by a fixed-height box) is left out; bookmarks inside page templates are ignored. html and markdown add h1–h3 with bookmarks: true.

table_of_contents lists the bookmarks with the page each one landed on, one clickable row per entry. It reads the outline when layout starts, so bookmarks declared after it are included.

text "Contents", size: 18
table_of_contents                     # every level, dotted leaders
table_of_contents(levels: 1..2, leader: :line, indent: 16, size: 9, color: "#374151")

Numbers are right-aligned in a fixed slot and filled in after pagination, so a long contents list paginates without reflowing. An entry whose target never paints keeps its title, with no number and no link.