Markup Formatting

Lists and Enumerations

List Indentation

List indentation is automatically corrected and standardized:

Before

1
 -   Fruit
2
      - Apple
3
  -     Banana
4
- Vegetable
5
      -    Carrot
6
      - Tomato

1
 -   Fruit
2
      - Apple
3
  -     Banana
4
- Vegetable
5
      -    Carrot
6
      - Tomato

After

1
- Fruit
2
  - Apple
3
  - Banana
4
- Vegetable
5
  - Carrot
6
  - Tomato
7

1
- Fruit
2
  - Apple
3
  - Banana
4
- Vegetable
5
  - Carrot
6
  - Tomato
7

Lists in Content Blocks

Lists within content blocks are properly formatted with surrounding linebreaks:

Before

1
#{
2
  [- single]
3
  [- indented
4
  - less
5
  ]
6
  [- indented
7
   - same
8
  - then less
9
   - then same
10
  ]
11
  [- indented
12
    - more
13
   - then same
14
  - then less
15
  ]
16
}

1
#{
2
  [- single]
3
  [- indented
4
  - less
5
  ]
6
  [- indented
7
   - same
8
  - then less
9
   - then same
10
  ]
11
  [- indented
12
    - more
13
   - then same
14
  - then less
15
  ]
16
}

After

1
#{
2
  [- single]
3
  [
4
    - indented
5
    - less
6
  ]
7
  [
8
    - indented
9
    - same
10
    - then less
11
      - then same
12
  ]
13
  [
14
    - indented
15
      - more
16
    - then same
17
    - then less
18
  ]
19
}
20

1
#{
2
  [- single]
3
  [
4
    - indented
5
    - less
6
  ]
7
  [
8
    - indented
9
    - same
10
    - then less
11
      - then same
12
  ]
13
  [
14
    - indented
15
      - more
16
    - then same
17
    - then less
18
  ]
19
}
20

Text Wrapping

When text wrapping is enabled with --wrap-text--wrap-text, typstyle intelligently wraps long lines while preserving important formatting and semantic structure:

Before

1
Let's say you have a long text that needs to be wrapped in the markup. This is a very long sentence.

1
Let's say you have a long text that needs to be wrapped in the markup. This is a very long sentence.

After

1
Let's say you have a long text
2
that needs to be wrapped in
3
the markup. This is a very
4
long sentence.
5

1
Let's say you have a long text
2
that needs to be wrapped in
3
the markup. This is a very
4
long sentence.
5

Wrapping Rules

typstyle applies specific wrapping logic based on node types:

Cannot break before: Markup markers (==, ++, --, //) and labels to prevent misinterpretation
Force hard breaks: Around block equations to keep them on exclusive lines
Preserve breaks after: Block elements, line comments, and structural nodes (code blocks, conditionals, loops)
Exclusive lines: Single non-text nodes or hash-prefixed expressions (e.g., #figure()#figure())
Soft breaks: Regular spaces become flexible break points unless restricted by above rules

Before

1
Some pieces should be exclusion except $"inline equation"$ and `raw`:
2
- This is a list
3
$ "block equation" $
4
#figure([Figures])
5
#figure([Labeled figures]) <label>
6
That's all! Wait, a linebreak \
7
should be \ kept at the end
8
\ of the line. \
9
But \ / never \ = break \ + before \ - markers
10
#[Never \ / Give \ = You \ + Up \
11
]
12
#([Man!\ ], [\ What\ can\ I\ say\ ?])
13
14
#let fig = (..) => []
15
#fig("image1")[Caption] <label1>
16
#fig("image2")[Caption] <label2>
17
18
This is a code block: #{
19
  // code block!
20
}
21
I don't want to eat the linebreak.
22
A blocky node should not stick #[
23
24
]
25
the content after it.
26
Not #if true { }
27
Not #while false { }
28
Not #for i in range(5) {}
29
Not #context 1
30
And block equations: $ eq $
31
And
32
also ``` block
33
  raw ```
34
but not ``` non-block raw ```
35
End
36
...

1
Some pieces should be exclusion except $"inline equation"$ and `raw`:
2
- This is a list
3
$ "block equation" $
4
#figure([Figures])
5
#figure([Labeled figures]) <label>
6
That's all! Wait, a linebreak \
7
should be \ kept at the end
8
\ of the line. \
9
But \ / never \ = break \ + before \ - markers
10
#[Never \ / Give \ = You \ + Up \
11
]
12
#([Man!\ ], [\ What\ can\ I\ say\ ?])
13
14
#let fig = (..) => []
15
#fig("image1")[Caption] <label1>
16
#fig("image2")[Caption] <label2>
17
18
This is a code block: #{
19
  // code block!
20
}
21
I don't want to eat the linebreak.
22
A blocky node should not stick #[
23
24
]
25
the content after it.
26
Not #if true { }
27
Not #while false { }
28
Not #for i in range(5) {}
29
Not #context 1
30
And block equations: $ eq $
31
And
32
also ``` block
33
  raw ```
34
but not ``` non-block raw ```
35
End
36
...

After

1
Some pieces should be
2
exclusion except
3
$"inline equation"$ and `raw`:
4
- This is a list
5
$ "block equation" $
6
#figure([Figures])
7
#figure([Labeled
8
  figures]) <label>
9
That's all! Wait, a linebreak
10
\
11
should be \ kept at the end \
12
of the line. \
13
But \ / never \ = break \ +
14
before \ - markers
15
#[Never \ / Give \ = You \ +
16
  Up \
17
]
18
#(
19
  [Man!\ ],
20
  [\ What\ can\ I\ say\ ?],
21
)
22
23
#let fig = (..) => []
24
#fig(
25
  "image1",
26
)[Caption] <label1>
27
#fig(
28
  "image2",
29
)[Caption] <label2>
30
31
This is a code block: #{
32
  // code block!
33
}
34
I don't want to eat the
35
linebreak. A blocky node
36
should not stick #[
37
38
]
39
the content after it. Not
40
#if true {}
41
Not #while false {}
42
Not #for i in range(5) {}
43
Not #context 1
44
And block equations:
45
$ eq $
46
And also
47
``` block
48
raw ```
49
but not ``` non-block raw ```
50
End
51
...
52

1
Some pieces should be
2
exclusion except
3
$"inline equation"$ and `raw`:
4
- This is a list
5
$ "block equation" $
6
#figure([Figures])
7
#figure([Labeled
8
  figures]) <label>
9
That's all! Wait, a linebreak
10
\
11
should be \ kept at the end \
12
of the line. \
13
But \ / never \ = break \ +
14
before \ - markers
15
#[Never \ / Give \ = You \ +
16
  Up \
17
]
18
#(
19
  [Man!\ ],
20
  [\ What\ can\ I\ say\ ?],
21
)
22
23
#let fig = (..) => []
24
#fig(
25
  "image1",
26
)[Caption] <label1>
27
#fig(
28
  "image2",
29
)[Caption] <label2>
30
31
This is a code block: #{
32
  // code block!
33
}
34
I don't want to eat the
35
linebreak. A blocky node
36
should not stick #[
37
38
]
39
the content after it. Not
40
#if true {}
41
Not #while false {}
42
Not #for i in range(5) {}
43
Not #context 1
44
And block equations:
45
$ eq $
46
And also
47
``` block
48
raw ```
49
but not ``` non-block raw ```
50
End
51
...
52

Multilingual Text Support

typstyle measures Unicode width and will not break between words if no space exists in the original text.

Before

1
这是一个中文段落，包含链接 https://typst.app/ 和*强调文本*。
2
続いて`コード要素`と https://docs.typst.app/ を含む日本語の段落です。
3
4
Mixed CJK and Latin: Visit 访问 https://example.com/文档 for documentation.
5
한글과 URL: https://한글.kr/ contains Korean text mixed with $alpha + beta$.
6
7
Multiple scripts: أهلاً بك في *타이프스트* เอกสาร with `inline code`.

1
这是一个中文段落，包含链接 https://typst.app/ 和*强调文本*。
2
続いて`コード要素`と https://docs.typst.app/ を含む日本語の段落です。
3
4
Mixed CJK and Latin: Visit 访问 https://example.com/文档 for documentation.
5
한글과 URL: https://한글.kr/ contains Korean text mixed with $alpha + beta$.
6
7
Multiple scripts: أهلاً بك في *타이프스트* เอกสาร with `inline code`.

After

1
这是一个中文段落，包含链接
2
https://typst.app/ 和*强调文本*。
3
続いて`コード要素`と
4
https://docs.typst.app/
5
を含む日本語の段落です。
6
7
Mixed CJK and Latin: Visit 访问
8
https://example.com/文档 for
9
documentation. 한글과 URL:
10
https://한글.kr/ contains Korean text
11
mixed with $alpha + beta$.
12
13
Multiple scripts: أهلاً بك في *타이프스트*
14
เอกสาร with `inline code`.
15

1
这是一个中文段落，包含链接
2
https://typst.app/ 和*强调文本*。
3
続いて`コード要素`と
4
https://docs.typst.app/
5
を含む日本語の段落です。
6
7
Mixed CJK and Latin: Visit 访问
8
https://example.com/文档 for
9
documentation. 한글과 URL:
10
https://한글.kr/ contains Korean text
11
mixed with $alpha + beta$.
12
13
Multiple scripts: أهلاً بك في *타이프스트*
14
เอกสาร with `inline code`.
15