list
ElementElement functions can be customized with set
and show
rules.
set
and show
rules.A bullet list.
Displays a sequence of items vertically, with each item introduced by a marker.
Example
- *Content*
- Text
- Math
- Layout
- Visualize
- Meta
- Symbols
- *Compute*
#list(
[Foundations],
[Calculate],
[Construct],
[Data Loading],
)

Syntax
This functions also has dedicated syntax: Start a line with a hyphen, followed by a space to create a list item. A list item can contain multiple paragraphs and other block-level content. All content that is indented more than an item's hyphen becomes part of that item.
ParametersParameters are the inputs to a function. They are specified in parentheses after the function name.
tight
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.If this is false
, the items are spaced apart with list
spacing. If it is true
, they use normal
leading instead. This makes the list more compact,
which can look better if the items are short.
Default: true
- If a list has a lot of text, and
maybe other inline content, it
should not be tight anymore.
- To make a list wide, simply insert
a blank line between the items.

marker
The marker which introduces each item.
Instead of plain content, you can also pass an array with multiple
markers that should be used for nested lists. If the list nesting depth
exceeds the number of markers, the last one is repeated. For total
control, you may pass a function that maps the list's nesting depth
(starting from 0
) to a desired marker.
Default: [•]
#set list(marker: [--])
- A more classic list
- With en-dashes
#set list(marker: ([•], [--]))
- Top-level
- Nested
- Items
- Items

indent
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The indent of each item.
Default: 0pt
body-indent
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The spacing between the marker and the body of each item.
Default: 0.5em
spacing
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The spacing between the items of a wide (non-tight) list.
If set to auto
, uses the spacing below blocks.
Default: auto
children
RequiredPositionalPositional parameters are specified in order, without names.VariadicVariadic parameters can be specified multiple times.
The bullet list's children.
When using the list syntax, adjacent items are automatically collected into lists, even through constructs like for loops.
#for letter in "ABC" [
- Letter #letter
]

list.item
functionElementElement functions can be customized with set
and show
rules.
set
and show
rules.A bullet list item.
ParametersParameters are the inputs to a function. They are specified in parentheses after the function name.
body
The item's body.