Typst MCP Server

# Block ## `block` A block-level container. Such a container can be used to separate content, size it, and give it a background or border. Blocks are also the primary way to control whether text becomes part of a paragraph or not. See [the paragraph documentation]($par/#what-becomes-a-paragraph) for more details. # Examples With a block, you can give a background to content while still allowing it to break across multiple pages. ```example #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. ```example #show heading: it => it.body = Blockless More text. #show heading: it => block(it.body) = Blocky More text. ``` ## Parameters ### width The block's width. ### height The block's height. When the height is larger than the remaining space on a page and [`breakable`]($block.breakable) is `{true}`, the block will continue on the next page with the remaining height. ### breakable Whether the block can be broken and continue on the next page. ### fill The block's background color. See the [rectangle's documentation]($rect.fill) for more details. ### stroke The block's border color. See the [rectangle's documentation]($rect.stroke) for more details. ### radius How much to round the block's corners. See the [rectangle's documentation]($rect.radius) for more details. ### inset How much to pad the block's content. See the [box's documentation]($box.inset) for more details. ### outset How much to expand the block's size without affecting the layout. See the [box's documentation]($box.outset) for more details. ### spacing The spacing around the block. When `{auto}`, inherits the paragraph [`spacing`]($par.spacing). For two adjacent blocks, the larger of the first block's `above` and the second block's `below` spacing wins. Moreover, block spacing takes precedence over paragraph [`spacing`]($par.spacing). Note that this is only a shorthand to set `above` and `below` to the same value. Since the values for `above` and `below` might differ, a [context] block only provides access to `{block.above}` and `{block.below}`, not to `{block.spacing}` directly. This property can be used in combination with a show rule to adjust the spacing around arbitrary block-level elements. ### above The spacing between this block and its predecessor. ### below The spacing between this block and its successor. ### clip Whether to clip the content inside the block. Clipping is useful when the block's content is larger than the block itself, as any content that exceeds the block's bounds will be hidden. ### sticky Whether this block must stick to the following one, with no break in between. This is, by default, set on heading blocks to prevent orphaned headings at the bottom of the page. ### body The contents of the block. ## Returns - content