Typst Grammar Authoring

Typst Grammar Authoring

Use this skill when the user wants help drafting, fixing, or validating Typst documents. Everything needed for grammar lookup lives in this file so it can be copied into another repository without sibling scripts or reference files.

Workflow

1. Start with the grammar lookup section in this file and pick the closest existing pattern before inventing new syntax.
2. Copy the smallest matching example, then adapt it incrementally.
3. Run typst compile after each meaningful edit. Any non-zero exit code is a blocking failure.
4. After compile succeeds, use HTML output to inspect rendered text and document structure when wording or content ordering matters.
5. Use SVG output plus Playwright MCP when you need to inspect visual layout, spacing, numbering, line breaks, or emphasis.

Validation

Compile validation:

typst compile --root . path/to/document.typ target/typst-grammar-authoring-check/document.pdf

Text validation through HTML:

typst compile --root . --features html path/to/document.typ target/typst-grammar-authoring-check/document.html
rg "expected text" target/typst-grammar-authoring-check/document.html

Visual validation through SVG:

typst compile --root . path/to/document.typ target/typst-grammar-authoring-check/document.svg
typst compile --root . path/to/document.typ target/typst-grammar-authoring-check/document-{0p}.svg

Playwright inspection:

• Use Playwright only after SVG generation succeeds.
• Open the SVG directly if the MCP server supports local files.
• Otherwise use a tiny local HTML wrapper that embeds the SVG, then capture a screenshot and inspect layout, spacing, numbering, line breaks, and emphasis.

Guardrails

• Keep all skill-authored prose and instructions in English.
• Canonical syntax examples may retain non-English literals from their source examples.
• Do not treat Tinymist or editor diagnostics as the source of truth.
• Do not assume sibling updater scripts, reference files, or repo-local metadata exist when using this skill elsewhere.
• Use {p} or {0p} in multi-page SVG output paths.
• Treat HTML export as a validation aid, not a production contract.
• Keep command examples platform-neutral by using forward-slash or placeholder paths.

Grammar Lookup

This section is embedded on purpose so the skill stays self-contained. Examples are derived from the unofficial tutorial grammar samples and kept compact so the lookup remains usable in a single file.

<!-- BEGIN GENERATED GRAMMAR LOOKUP -->

Base Elements

• paragraph: writing-markup
• heading: = Heading; == Heading
• strong: *Strong*
• emph: _emphasis_; *_emphasis_*
• list:

+ List 1
+ List 2

• continue-list:

4. List 1
+ List 2

• emum:

- Enum 1
- Enum 2

• mix-list-emum:

- Enum 1
  + Item 1
- Enum 2

• raw:

`code`

• long-raw:

``` code```

• lang-raw:

```rs  trait World```

• blocky-raw:

```typ
= Heading
```

• image: #image("/assets/files/香風とうふ店.jpg", width: 50pt)
• image-stretch: #image("/assets/files/香風とうふ店.jpg", width: 50pt, height: 50pt, fit: "stretch")
• image-inline: 在一段话中插入一个#box(baseline: 0.15em, image("/assets/files/info-icon.svg", width: 1em))图片。
• figure:

#figure(```typ
#image("/assets/files/香風とうふ店.jpg")
```, caption: [用于加载香風とうふ店送外卖的宝贵影像的代码])

• link: #link("https://zh.wikipedia.org")[维基百科]
• http-link: https://zh.wikipedia.org
• internal-link:

== 某个标题 <ref-internal-link>
#link(<ref-internal-link>)[链接到某个标题]

• table: #table(columns: 2, [111], [2], [3])
• table-align: #table(columns: 2, align: center, [111], [2], [3])
• inline-math: $sum_x$
• display-math: $ sum_x $
• escape-sequences: >\_<
• unicode-escape-sequences: \u{9999}
• newline-by-space: A \ B
• newline:

A \
B

• shorthand: 北京--上海
• shorthand-space: A~B
• inline-comment: // 行内注释
• cross-line-comment:

/* 行间注释
  */

• box: 在一段话中插入一个#box(baseline: 0.15em, image("/assets/files/info-icon.svg", width: 1em))图片。

Text Styling

• highlight: #highlight[高亮一段内容]
• underline: #underline[Language]
• underline-evade:

#underline(
  evade: false)[ጿኈቼዽ]

• overline: #overline[ጿኈቼዽ]
• strike: #strike[ጿኈቼዽ]
• subscript: 威严满满#sub[抱头蹲防]
• superscript: 香風とうふ店#super[TM]
• text-size: #text(size: 24pt)[一斤鸭梨]
• text-fill: #text(fill: blue)[蓝色鸭梨]
• text-font: #text(font: "Microsoft YaHei")[板正鸭梨]