TypstDocumentation

parShowable
Question mark

Arrange text, spacing and inline-level nodes into a paragraph.

Although this function is primarily used in set rules to affect paragraph properties, it can also be used to explicitly render its argument onto a paragraph of its own.

Example

#set par(indent: 1em, justify: true)
#show par: set block(spacing: 0.65em)

We proceed by contradiction.
Suppose that there exists a set
of positive integers $a$, $b$, and
$c$ that satisfies the equation
$a^n + b^n = c^n$ for some
integer value of $n > 2$.

Without loss of generality,
let a be the smallest of the
three integers. Then, we ...
Preview

Parameters
Question mark

body
contentRequiredPositional
Question mark

The contents of the paragraph.

indent
lengthSettable
Question mark

The indent the first line of a consecutive paragraph should have.

The first paragraph on a page will never be indented.

By typographic convention, paragraph breaks are indicated by either some space between paragraphs or indented first lines. Consider turning the paragraph spacing off when using this property (e.g. using #show par: set block(spacing: 0pt)).

leading
lengthSettable
Question mark

The spacing between lines.

The default value is 0.65em.

justify
booleanSettable
Question mark

Whether to justify text in its line.

Hyphenation will be enabled for justified paragraphs if the text property hyphenate is set to auto and the current language is known.

Note that the current alignment still has an effect on the placement of the last line except if it ends with a justified line break.

linebreaks
autostringSettable
Question mark

How to determine line breaks.

When this property is set to auto, its default value, optimized line breaks will be used for justified paragraphs. Enabling optimized line breaks for ragged paragraphs may also be worthwhile to improve the appearance of the text.

#set page(width: 190pt)
#set par(linebreaks: "simple")
Some texts are frustratingly
challenging to break in a
visually pleasing way. This
very aesthetic example is one
of them.

#set par(linebreaks: "optimized")
Some texts are frustratingly
challenging to break in a
visually pleasing way. This
very aesthetic example is one
of them.
Preview