Info
This site is generated using the static site generator developed by the Typst Community. Please adjust the text content of this banner according to your usage requirements. At Typst GmbH's request, when publishing documentation, you must clearly indicate that it is non-official and display the version of Typst being documented. For details, refer to Issue #874 on typst/typst.
TypstDocumentEnglish
v0.dev.2025-09-12

pagebreak
Element
Element
Element functions can be customized with set and show rules.

A manual page break.

Must not be used inside any containers.

Example

The next page contains
more details on compound theory.
#pagebreak()

== Compound Theory
In 1984, the first ...
Preview

Even without manual page breaks, content will be automatically paginated based on the configured page size. You can set the page height to auto to let the page grow dynamically until a manual page break occurs.

Pagination tries to avoid single lines of text at the top or bottom of a page (these are called widows and orphans). You can adjust the text.costs parameter to disable this behavior.

Parameter
Parameter
Parameters are input values for functions. Specify them in parentheses after the function name.

weak
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

If true, the page break is skipped if the current page is already empty.

Default value:

false

to
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

If given, ensures that the next page will be an even/odd page, with an empty page in between if necessary.

Available string values:
  • even

    Next page will be an even page.

  • odd

    Next page will be an odd page.

Default value:

none

Show example
#set page(height: 30pt)

First.
#pagebreak(to: "odd")
Third.
Preview
Open official docs

Search