PDF Options
Bookmarks
Create a navigable table of contents in the PDF viewer:
<Bookmark select="'Chapter 1'" level="1"/>
<Bookmark select="'Section 1.1'" level="2"/>
<Bookmark select="'Section 1.2'" level="2"/>
<Bookmark select="'Chapter 2'" level="1"/>Use open="yes" to expand a bookmark node by default.
Links
Create clickable links with <A>:
<!-- External link -->
<Paragraph>
<A href="https://example.com"><Value>Visit our website</Value></A>
</Paragraph>
<!-- Internal link (to a mark) -->
<Mark select="'chapter1'"/>
<!-- ... later ... -->
<A link="chapter1"><Value>See Chapter 1</Value></A>Page destinations
Every page automatically gets a named destination (page-1, page-2, …). You can link to a specific page using the page attribute:
<A page="2"><Value>Go to page 2</Value></A>This also works in HTML mode (htmlbag) using <a href="#page-2">Go to page 2</a>.
PDF metadata
Set document properties with <PDFOptions>:
<PDFOptions
author="ACME Corp"
title="Product Catalog 2026"
subject="Complete product listing"
creator="XTS"/>Viewer preferences
Control how the PDF opens:
<PDFOptions
displaymode="fullscreen"
duplex="DuplexFlipLongEdge"
printscaling="None"
showhyperlinks="false"/>