block
ElementElement functions can be customized with set
and show
rules.
set
and show
rules.A block-level container.
Such a container can be used to separate content, size it and give it a background or border.
Examples
With a block, you can give a background to content while still allowing it to break across multiple pages.
#set page(height: 100pt)
#block(
fill: luma(230),
inset: 8pt,
radius: 4pt,
lorem(30),
)


Blocks are also useful to force elements that would otherwise be inline to become block-level, especially when writing show rules.
#show heading: it => it.body
= Blockless
More text.
#show heading: it => block(it.body)
= Blocky
More text.

ParametersParameters are the inputs to a function. They are specified in parentheses after the function name.
width
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The block's width.
Default: auto
#set align(center)
#block(
width: 60%,
inset: 8pt,
fill: silver,
lorem(10),
)

height
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The block's height. When the height is larger than the remaining space on
a page and breakable
is true
, the block
will continue on the next page with the remaining height.
Default: auto
#set page(height: 80pt)
#set align(center)
#block(
width: 80%,
height: 150%,
fill: aqua,
)


breakable
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.Whether the block can be broken and continue on the next page.
Default: true
#set page(height: 80pt)
The following block will
jump to its own page.
#block(
breakable: false,
lorem(15),
)


fill
The block's background color. See the rectangle's documentation for more details.
Default: none
stroke
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The block's border color. See the rectangle's documentation for more details.
Default: none
radius
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.How much to round the block's corners. See the rectangle's documentation for more details.
Default: 0pt
inset
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.How much to pad the block's content. See the rectangle's documentation for more details.
Default: 0pt
outset
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.How much to expand the block's size without affecting the layout. See the rectangle's documentation for more details.
Default: 0pt
spacing
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The spacing around this block. This is shorthand to set above
and
below
to the same value.
Default: 1.2em
#set align(center)
#show math.equation: set block(above: 8pt, below: 16pt)
This sum of $x$ and $y$:
$ x + y = z $
A second paragraph.

above
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The spacing between this block and its predecessor. Takes precedence
over spacing
. Can be used in combination with a show rule to adjust
the spacing around arbitrary block-level elements.
Default: 1.2em
below
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The spacing between this block and its successor. Takes precedence
over spacing
.
Default: 1.2em
clip
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.Whether to clip the content inside the block.
Default: false
body
The contents of the block.
Default: none