Docs

Pages

Learn how to split your document into pages with different layouts.

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

{{ page                  # page break
  orient: landscape      # page orientation
  cols: 2                # number of columns
  column-fill: auto      # fill columns sequentially (default: balance)
  type: fp               # page type
}}

The {{ page }} section creates a new page in your document. Each page can have its own orientation, column layout and type. Content before the first {{ page }} becomes page 0.

The page section is always self-closing — there is no {{ /page }} tag.

keyword: orient / orientation / o
options: portrait / p / port | landscape / l / land
default: portrait

Controls whether the page is portrait (tall) or landscape (wide).

keyword: cols
options: 1 | 2 | 3
default: 1

Sets the number of columns for the page layout. Content flows across columns left to right.

keyword: column-fill
options: balance | auto
default: balance

Controls how content is distributed across columns when cols is greater than 1.

  • balance — content is split evenly so all columns end at roughly the same height. This is the CSS default and matches what most print and editorial layouts expect.
  • auto — content fills the first column to the bottom of the page before flowing into the next. Useful for newspaper-style pages or when you want the second column reserved for overflow only.

column-fill is ignored on single-column pages.

Use {{ colbreak }} inside a multi-column page to force the following content into the next column. It is a self-closing token with no attributes:

{{ page
cols: 2
column-fill: auto
}}

This text fills the first column.

{{ colbreak }}

This text starts at the top of the second column, regardless of how
much space was left below the previous block.

{{ colbreak }} only takes effect on CSS multicolumn pages — pages with cols > 1 and no height: 100% vis or paragraph child. When a flex-height child is present the page is rewrapped into manual column buckets and {{ colbreak }} is currently ignored; in that case, lay out the columns by ordering content explicitly or split into separate {{ page }}s.

keyword: type
options: fp | index | centered | blank

Controls the page type:

  • fp — front page, typically used for cover pages
  • index — index or table of contents style
  • centered — centered content layout
  • blank — empty page
keyword: footer
options: true | false | "Custom footer text"
default: true

Controls whether a footer is displayed and optionally sets custom footer text.

keyword: pnum
options: "auto" | "custom string"

Overrides the page number display.

keyword: overflow
options: auto

Controls whether content that exceeds the page should automatically create new pages.

keyword: ref
options: FQNP | shortname | local path | global path

Embeds another novem visual as a full-page element. Supports references to documents (/d/), plots (/p/) and grids (/g/). The embedded visual replaces the page content entirely.

# Cover Page

{{ page
orient: portrait
}}

# Chapter One

Content for chapter one.

{{ page
orient: landscape
cols: 2
}}

## Data Overview

Two-column landscape layout for charts.


{{ page
ref: /u/novem_demo/d/mkt_research
}}


{{ page
orient: landscape
ref: /u/novem_demo/g/nei_rgn_dash
}}


---
title: Quarterly Review
---

# Q4 2024 Review

{{ page
orient: portrait
type: fp
}}

## Executive Summary

{{ page
orient: landscape
cols: 2
}}

## Charts and Data

{{ page
orient: portrait
type: centered
}}

## Conclusions
Next
Visualisation