{"route":"/en-US-v0.14.1/reference/layout/columns/","title":"Columns","description":"Documentation for the `columns` function.","part":null,"outline":[{"id":"summary","name":"Summary","children":[]},{"id":"example","name":"Example","children":[]},{"id":"page-level","name":"Page Level","children":[]},{"id":"breaking-out","name":"Breaking Out","children":[]},{"id":"parameters","name":"Parameters","children":[{"id":"parameters-count","name":"count","children":[]},{"id":"parameters-gutter","name":"gutter","children":[]},{"id":"parameters-body","name":"body","children":[]}]}],"body":{"kind":"func","content":{"path":[],"name":"columns","title":"Columns","keywords":[],"oneliner":"Separates a region into multiple equally sized columns.","element":true,"contextual":false,"deprecationMessage":null,"deprecationUntil":null,"details":[{"kind":"html","content":"

Separates a region into multiple equally sized columns.

\n

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

\n

When arranging content across multiple columns, use colbreak\nto explicitly continue in the next column.

\n

Example

\n
#columns(2, gutter: 8pt)[\n  This text is in the\n  first column.\n\n  #colbreak()\n\n  This text is in the\n  second column.\n]\n
\"Preview\"
\n

Page-level columns

\n

If you need to insert columns across your whole document, use the page\nfunction's columns parameter instead. This will create\nthe columns directly at the page-level rather than wrapping all of your\ncontent in a layout container. As a result, things like\npagebreaks, footnotes, and line\nnumbers will continue to work as expected. For more information,\nalso read the relevant part of the page setup\nguide.

\n

Breaking out of columns

\n

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

\n
#set page(columns: 2, height: 150pt)\n\n#place(\n  top + center,\n  scope: "parent",\n  float: true,\n  text(1.4em, weight: "bold")[\n    My document\n  ],\n)\n\n#lorem(40)\n
\"Preview\"
"}],"self":false,"params":[{"name":"count","details":[{"kind":"html","content":"

The number of columns.

"}],"types":["int"],"strings":[],"default":"2","positional":true,"named":false,"required":false,"variadic":false,"settable":true},{"name":"gutter","details":[{"kind":"html","content":"

The size of the gutter space between each column.

"}],"types":["relative"],"strings":[],"default":"4% + 0pt","positional":false,"named":true,"required":false,"variadic":false,"settable":true},{"name":"body","details":[{"kind":"html","content":"

The content that should be layouted into the columns.

"}],"types":["content"],"strings":[],"default":null,"positional":true,"named":false,"required":true,"variadic":false,"settable":false}],"returns":["content"],"scope":[]}}}