Markdown

Page references

Insert the live page number of any heading — resolved after pagination, so it stays correct as the document reflows.

AI assisted, human approved — novem uses AI to review and keep our documentation up to date.

Available in: documents only.

Our runway is healthy (more detail on page
{pageref##Financial performance and runway}).

A page reference inserts the page number of a heading somewhere else in the document. You write which heading you mean; novem fills in the number.

The number is resolved after the document has been laid out — once pages have been split and renumbered — so it is always the real, final page the heading lands on, even when content reflows or auto-paginates onto extra pages.

{pageref##Heading text}
  • It starts with pageref.
  • The run of #s is the heading level you're targeting: # matches an h1, ## an h2, ### an h3, and so on.
  • The rest is the heading text to match.

The target is matched against the headings of that level, comparing them normalised: whitespace is removed, trailing {instructions} (like {colspan:all}) are stripped, and case is ignored. So all of these match the heading ## Financial performance and runway {colspan:all}:

{pageref##Financial performance and runway}
{pageref##financial   PERFORMANCE and Runway}

If more than one heading matches, the first one (in document order) wins.

If nothing matches, the reference renders as #N/A so it's easy to spot.

The page number as plain text:

See page {pageref##Capital allocation} for the breakdown.

Wrap the heading text in parentheses to make the page number a link that jumps to the heading:

See page {pageref##(Capital allocation)} for the breakdown.

Give it your own label with a markdown-style [label](target) — the label becomes the clickable text (linking to the heading) instead of the number:

The full breakdown is {pageref##[on the capital page](Capital allocation)}.


## Summary

Finally, at our current costs and revenue levels we have a healthy runway of at
least 18 months (more details on page
{pageref##Financial performance and runway}).

{{ page }}

## Financial performance and runway

...

For our strategy see {pageref##[Strategy & outlook](Strategy and outlook)};
capital allocation is covered on page {pageref###(Capital allocation)}.
Next
Spans