Info
This site is generated using the static site generator developed by the Typst Community. Please adjust the text content of this banner according to your usage requirements. At Typst GmbH's request, when publishing documentation, you must clearly indicate that it is non-official and display the version of Typst being documented. For details, refer to Issue #874 on typst/typst.
TypstDocumentEnglish
v0.dev.2025-09-12

underline
Element
Element
Element functions can be customized with set and show rules.

Underlines text.

Example

This is #underline[important].
Preview

Parameter
Parameter
Parameters are input values for functions. Specify them in parentheses after the function name.

stroke
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

How to stroke the line.

If set to auto, takes on the text's color and a thickness defined in the current font.

Default value:

auto

Show example
Take #underline(
  stroke: 1.5pt + red,
  offset: 2pt,
  [care],
)
Preview

offset
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

The position of the line relative to the baseline, read from the font tables if auto.

Default value:

auto

Show example
#underline(offset: 5pt)[
  The Tale Of A Faraway Line I
]
Preview

extent
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

The amount by which to extend the line beyond (or within if negative) the content.

Default value:

0pt

Show example
#align(center,
  underline(extent: 2pt)[Chapter 1]
)
Preview

evade
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

Whether the line skips sections in which it would collide with the glyphs.

Default value:

true

Show example
This #underline(evade: true)[is great].
This #underline(evade: false)[is less great].
Preview

background
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

Whether the line is placed behind the content it underlines.

Default value:

false

Show example
#set underline(stroke: (thickness: 1em, paint: maroon, cap: "round"))
#underline(background: true)[This is stylized.] \
#underline(background: false)[This is partially hidden.]
Preview

body
Required
Required
Required parameters must be specified when calling the function.
Positional
Positional
Positional parameters can be set by specifying them in order, omitting the parameter name.

The content to underline.

Open official docs

Search