par
ShowableShowable functions can be customized with show
rules.
show
rules.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 ...

ParametersParameters are the inputs to a function. They are specified in parentheses after the function name.
body
The contents of the paragraph.
indent
lengthSettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.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
lengthSettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The spacing between lines.
The default value is 0.65em
.
justify
booleanSettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.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
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.
- "simple"
Determine the line breaks in a simple first-fit style.
- "optimized"
Optimize the line breaks for the whole paragraph.
Typst will try to produce more evenly filled lines of text by considering the whole paragraph when calculating line breaks.
#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.
