• 
• 
• Reference
• 
• Layout
• 
• Paragraph

parShowable

Showable functions can be customized with 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 ...

Parameters

Parameters are the inputs to a function. They are specified in parentheses after the function name.

body

contentRequiredPositional

Positional parameters are specified in order, without names.

The contents of the paragraph.

indent

lengthSettable

Settable parameters can be customized for all following uses of the function with a 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

lengthSettable

Settable parameters can be customized for all following uses of the function with a set rule.

The spacing between lines.

The default value is 0.65em.

justify

booleanSettable

Settable parameters can be customized for all following uses of the function with a 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

autostringSettable

Settable parameters can be customized for all following uses of the function with a set rule.

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.

View example

#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.

Page BreakPrevious page

Paragraph BreakNext page