block
Element
Element 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.
Parameters
Parameters are the inputs to a function. They are specified in parentheses after the function name.
width
The block's width.
Default:auto
View example
#set align(center)
#block(
width: 60%,
inset: 8pt,
fill: silver,
lorem(10),
)
height
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
View example
#set page(height: 80pt)
#set align(center)
#block(
width: 80%,
height: 150%,
fill: aqua,
)
breakable
Settable
Settable 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
View example
#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
The block's border color. See the rectangle's documentation for more details.
Default:(:)
radius
Settable
Settable 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:(:)
inset
Settable
Settable 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 box's documentation for more details.
Default:(:)
outset
Settable
Settable 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 box's documentation for more details.
Default:(:)
spacing
The spacing around this block. This is shorthand to set above and
below to the same value.
Default:1.2em
View example
#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
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
The spacing between this block and its successor. Takes precedence
over spacing.
Default:1.2em
clip
Settable
Settable 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