Page format

The .pageformat ^{docs ↗} function configures the page format. All its parameters are optional, and if left unset, they delegate their default value to the underlying renderer depending on the document type.

Parameter	Description	Accepts	Supported documents
`size`	Name of the paper format.	`A0`..`A10`, `B0`..`B5`, `letter`, `legal`, `ledger`	`paged`, `slides`
`width`	Page width. If `size` is set too, this value overrides its width.	`Size`, e.g. `300px`, `15cm`, `5.8in`	`plain`, `paged`, `slides`, `docs`
`height`	Page height. If `size` is set too, this value overrides its height.	`Size`, e.g. `300px`, `15cm`, `5.8in`	`paged`, `slides`
`orientation`	Whether width and height of the paper format (`size`) should be swapped. This defaults to `portrait` for `plain` and `paged` documents and to `landscape` for `slides`.	`portrait`, `landscape`	`paged`, `slides`
`margin`	Blank space between page borders and content area.	`Sizes`, e.g. `1cm`, `15mm 30px`, `2in 1in 3in 2in`	`plain`, `paged`, `slides`
`bordertop`, `borderright`, `borderbottom`, `borderleft`	Thickness of the border at each side of the content area.	`Size`	`plain`, `paged`, `slides`
`bordercolor`	Color of the border around the content area.	`Color`	`plain`, `paged`, `slides`
`columns`	Number of columns in each page. If set to 2 or higher, the document has a multi-column layout.	Positive integer	`plain`, `paged`, `slides`
`alignment`	Horizontal content and text alignment.	`start` (default in `slides`), `center`, `end`, `justify` (default in `plain` and `paged`)	`plain`, `paged`, `slides`, `docs`

Content area

Each page consists of a content area in which the main content is displayed, and a margin area, a blank outline that may host page margin content such as page counters.

Margins

The margin parameter affects the size of the margin area, reducing the surface of the content area.

Example 1

.pageformat margin:{4cm}

Borders

The bordertop, borderright, borderbottom, borderleft, and bordercolor parameters allow customization of borders around the content area of each page in paged and slides documents.

If you specify at least one side, the border applies to the specified sides. If you do not specify the color, it uses the default foreground text color.
If you do not specify any side but do specify the color, the border applies to all sides with a default thickness.

Example 2

.pageformat bordertop:{1px} borderbottom:{4px}