第一份 Typst 文档
从一个能编译的最小例子开始,分清 Typst 的标记、代码和公式三种写法,学会写标题、段落、列表、公式和交叉引用。
最后核对:2026-11-13Typst 和 LaTeX 一样,在源文件里写文字和标记,编译之后得到 PDF。它的不同之处在于编译几乎是即时的,标记更接近 Markdown,报错也更容易读懂。下面这份文档包含了写论文时最常用的几样东西,先打开它编译一次,再对照着往下读。
// title: 第一份 Typst 文档
// 以 // 开头的是注释,不会出现在 PDF 里
// ---- 设置:以 # 开头的是代码,#set 改变之后所有内容的默认样式 ----
#set text(font: ("Libertinus Serif", "Noto Serif CJK SC"), lang: "zh", region: "cn")
#set par(justify: true, first-line-indent: (amount: 2em, all: true))
#set heading(numbering: "1.1") // 标题自动编号
#set math.equation(numbering: "(1)") // 独立公式自动编号
// ---- 正文:直接写,不需要 \begin{document} ----
#align(center, text(size: 18pt, weight: "bold")[我的第一份 Typst 文档])
#align(center)[张三]
#outline() // 目录,由各级标题自动生成
= 段落
一段话写在一行里,靠编辑器自动折行。
空一行才开始新的一段。字体、缩进、行距都由上面的 #raw("#set") 决定,不需要自己敲空格。
= 强调与列表
*粗体*表示强调,_这样_也表示强调(中文字体通常没有斜体,所以常用粗体)。
- 无序列表的一项
- 另一项
+ 有序列表会自动编号
+ 增删条目后编号自动更新
= 公式与引用 <sec:math>
行内公式写在两个美元符号之间:$E = m c^2$。美元符号内侧各留一个空格,就成了单独成行的公式:
$ a^2 + b^2 = c^2 $ <eq:pythagoras>
// 尖括号起名字,@名字 引用;编号变了,引用跟着变
@eq:pythagoras 出现在 @sec:math。
== 特殊字符
这些字符在 Typst 里有特殊含义,要印出来得在前面加反斜杠:
\# #h(1em) \$ #h(1em) \* #h(1em) \_ #h(1em) \@ #h(1em) \< #h(1em) \\

三种写法
Typst 的源文件里混着三种写法,分清它们,后面的内容就都好懂了。
标记是默认的写法,用来写正文:直接写的文字就是段落,= 开头是标题,*粗体*、- 列表项 这些符号有固定的含义。
代码以 # 开头,用来调用函数和做设置,例如 #outline() 生成目录,#set text(size: 12pt) 设置字号。函数的参数写在圆括号里;参数是一段正文内容时写在方括号里,如 #align(center)[张三]。
公式写在一对美元符号之间,里面是另一套专门写数学的语法。
以 // 开头的是注释,到行尾为止;/* ... */ 是可以跨行的注释。
设置:set 规则
Typst 没有导言区,也没有文档类。文档的样子靠文件开头的几条 #set 规则决定:#set 后面跟一个函数和若干参数,意思是"从这里开始,这个函数都默认用这些参数"。
示例开头的四条规则分别设置了字体和语言、段落的两端对齐与首行缩进、标题的编号格式、公式的编号格式。中文文档的这几项设置在中文排版与字体里逐项解释。
#set 写在哪里,就从哪里开始生效,所以全文的设置都放在文件最前面。
标题和目录
一个等号加空格是一级标题,两个等号是二级标题,依此类推。标题默认不编号,#set heading(numbering: "1.1") 打开编号,引号里的 1.1 是编号的样式。
#outline() 在它所在的位置生成目录,标题的增删会立即反映在目录里。
段落和强调
空一行是新的一段。和 LaTeX 不同的是,两个汉字之间的换行会在 PDF 里变成一个空格,所以一段话最好写在一行里,靠编辑器自动折行。
*粗体* 是粗体,_强调_ 是强调。中文字体通常没有斜体,强调中文时用粗体。
列表
- 加空格开头的行是无序列表,+ 加空格开头的行是有序列表,编号自动生成。把一项缩进两个空格,它就成为上一项的子列表。
公式
美元符号紧贴内容是行内公式:$E = m c^2$。美元符号内侧各留一个空格,就成了单独成行的公式:$ E = m c^2 $。
公式里连着写的多个字母会被当成一个名字,所以 m 乘以 c 要写成 m c,中间留空格;希腊字母和常用符号直接写名字,如 alpha、pi、sum,不需要反斜杠。更多写法见数学公式。
交叉引用
在要引用的东西后面用尖括号起一个名字,如 <eq:pythagoras>,正文里写 @eq:pythagoras 就能引用它。Typst 会根据被引用的对象自动加上"式""图""表"这样的前缀,编号变了引用也跟着变。
能被引用的东西需要有编号:标题要打开 heading 的编号,公式要打开 math.equation 的编号,示例开头的两条 #set 就是为此而写的。
特殊字符
# $ * _ @ < \ 这些字符在标记里有特殊含义。要把它们印出来,在前面加反斜杠,如 \#、\$、\*。
