Markdown

Variables

Learn how to embed live variable values from your visualisations inline in your documents.

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

Available in: documents only.

Revenue was {/u/acme/p/revenue/v/total} million.

Overview

Variables let you embed live values from any novem visualisation directly in your document text. When the underlying data changes, the variable value updates automatically across all outputs.

Variables use the Fully Qualified Novem Path (FQNP) syntax wrapped in single curly braces. They render inline — within paragraphs, lists, callouts and other content.

Syntax

The variable syntax follows the pattern:

{/u/<username>/<type>/<vis_id>/v/<var_name>}

Where:

  • <username> — the novem username who owns the visualisation
  • <type> — the vis type: p (plot), g (grid), m (mail), d (doc), r (repo), j (job)
  • <vis_id> — the visualisation identifier
  • <var_name> — the variable name defined on the visualisation

Where variables work

Variables can be used anywhere inline text is supported:

  • Regular paragraphs
  • Inside {{ para }} sections
  • Inside {{ callout }} sections
  • Inside list items
  • Inside [[span: sections]]

Variables are not processed inside code blocks or inline code.

Examples

Inline metric

The index returned {/u/acme/p/nei/v/ytd_return} year to date.

Multiple variables in a paragraph

Revenue hit {/u/acme/p/rev/v/total} this quarter, up from
{/u/acme/p/rev/v/prev} last quarter — a {/u/acme/p/rev/v/growth}
increase.

Inside a styled paragraph

{{ para
  b: l3 blue-500
  p: l2
}}
**Current value:** {/u/acme/p/dashboard/v/current_price}
{{ /para }}

Inside a list

- North America: {/u/acme/p/regions/v/na_return}
- Europe: {/u/acme/p/regions/v/eu_return}
- Asia Pacific: {/u/acme/p/regions/v/apac_return}
Next
HTML