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

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

Separates a region into multiple equally sized columns.

The column function lets you separate the interior of any container into multiple columns. It will currently not balance the height of the columns. Instead, the columns will take up the height of their container or the remaining height on the page. Support for balanced columns is planned for the future.

Page-level columns

If you need to insert columns across your whole document, use the page function's columns parameter instead. This will create the columns directly at the page-level rather than wrapping all of your content in a layout container. As a result, things like pagebreaks, footnotes, and line numbers will continue to work as expected. For more information, also read the relevant part of the page setup guide.

Breaking out of columns

To temporarily break out of columns (e.g. for a paper's title), use parent-scoped floating placement:

#set page(columns: 2, height: 150pt)

#place(
  top + center,
  scope: "parent",
  float: true,
  text(1.4em, weight: "bold")[
    My document
  ],
)

#lorem(40)
Preview

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

count
Positional
Positional
Positional parameters can be set by specifying them in order, omitting the parameter name.
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

The number of columns.

Default value:

2

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

The size of the gutter space between each column.

Default value:

4% + 0pt

body
Required
Required
Required parameters must be specified when calling the function.
Positional
Positional
Positional parameters can be set by specifying them in order, omitting the parameter name.

The content that should be layouted into the columns.

Open official docs

Search