文章

Typst 数学公式

·

Typst 没有采用标准的 LaTeX 符号,所以我们需要记录一下 Typst 的数学符号,方便随时查阅。

1. 基本数学符号

1.1. 行内公式与独立公式

$x^2 + y^2$ 是行内公式;首尾都有空白的 $ x^2 + y^2 $ 是独立公式。独立公式默认居中,适合较长的计算、推导与需要编号的公式。

设 $a > 0$,则 $sqrt(a^2) = a$。

$ (a + b)^2 = a^2 + 2 a b + b^2 $

设 𝑎>0,则 𝑎2=𝑎。

(𝑎+𝑏)2=𝑎2+2𝑎𝑏+𝑏2

1.2. 字母、名字与文字

单个字母通常直接作为数学变量排版;连续多个字母会被当作符号或函数的名字。因此乘积写作 a b,文字写作 "速度",命名符号写作 alpha。sin 是内置算子,s i n 则是三个字母的乘积。

符号Typst 语法符号Typst 语法符号Typst 语法
𝑎𝑏a b𝑥𝑦𝑧x y z𝛼+𝛽alpha + beta
sin𝑥sin x速度"速度"𝑥初始x_"初始"

数学模式中可以直接写 Unicode 字符,例如 $α + β ≤ γ$。使用命名符号通常更便于键盘输入与搜索。正文中插入符号时使用 #sym.alpha,正文中调用数学函数则使用 #math.sqrt([2]);这里的内容块 [2] 是函数需要的排版内容。

1.3. 函数参数与代码插值

数学函数用圆括号调用,例如 frac(a, b)。逗号分隔参数,矩阵中的分号分隔行;布尔值、长度、百分比、数组等代码值前需要加 #,如 reverse: #true、size: #150%。字符串参数可以直接写成 delim: "["。

#let n = 6
$ a_#n = 1/#n $
$ vec(2, 3, delim: "[") $
𝑎6=16[23]

在数学函数的参数中,需要显示字面的逗号或分号时用 \,、\; 转义。冒号紧跟标识符时可能被解释为命名参数,可在冒号前留空格,例如 f : X -> Y。

2. 希腊字母与特殊字母

2.1. 小写希腊字母

符号Typst 语法符号Typst 语法符号Typst 语法
𝛼alpha𝛽beta𝛾gamma
𝛿delta𝜀epsilon𝜁zeta
𝜂eta𝜃theta𝜄iota
𝜅kappa𝜆lambda𝜇mu
𝜈nu𝜉xi𝜊omicron
𝜋pi𝜌rho𝜎sigma
𝜏tau𝜐upsilon𝜑phi
𝜒chi𝜓psi𝜔omega

2.2. 大写希腊字母

大写名称的首字母大写,例如 Gamma、Delta、Omega。部分字形与拉丁字母相似,但名称和语义仍可区分。

符号Typst 语法符号Typst 语法符号Typst 语法
ΑAlphaΒBetaΓGamma
ΔDeltaΕEpsilonΖZeta
ΗEtaΘThetaΙIota
ΚKappaΛLambdaΜMu
ΝNuΞXiΟOmicron
ΠPiΡRhoΣSigma
ΤTauΥUpsilonΦPhi
ΧChiΨPsiΩOmega

2.3. 常用字形变体

.alt 表示另一种字形,大小写也有区别。epsilon.alt、phi.alt 分别是 epsilon、phi 的字形变体。

符号Typst 语法符号Typst 语法符号Typst 语法
𝜀epsilon𝜖epsilon.alt𝜗theta.alt
𝜘kappa.alt𝜛pi.alt𝜚rho.alt
𝜍sigma.alt𝜑phi𝜙phi.alt
ϴTheta.altϝdigammaϜDigamma

2.4. 其他特殊字母

符号Typst 语法符号Typst 语法符号Typst 语法
ℓellhupright(h)ℏplanck
ℜReℑIm𝚤dotless.i
𝚥dotless.jℵalephℶbeth
ℷgimelℸdalethÅangstrom

Re、Im 是特殊字母符号;直立的文字算子写作 op("Re")、op("Im")。planck 对应约化普朗克常数的符号 ℏ。虚数单位和自然常数也常用直立体 upright(i)、upright(e)。

3. 运算符与关系符号

3.1. 基本算术与复合运算

符号Typst 语法符号Typst 语法符号Typst 语法
++−-±plus.minus
∓minus.plus×times÷div
⋅dot∗ast⋆star
∘compose○circle•bullet
⊕plus.o⊖minus.o⊗times.o
⊙dot.o/slash\backslash
⊞plus.square⊟minus.square⊠times.square
⊡dot.square◇diamond△triangle

* 在数学模式中产生星号运算符,不是通常的乘号。数值相乘可写 times,点乘可写 dot,普通字母的乘积常直接写 a b。a / b 会排成上下分式;希望保留斜杠时写 a slash b。

3.2. 相等、近似与定义

符号Typst 语法符号Typst 语法符号Typst 语法
==≠!=≡equiv
≢equiv.not≈approx≉approx.not
∼tilde.op≃tilde.eq≁tilde.not
≅tilde.equiv∝prop≐eq.dot
≝eq.def≜eq.delta≟eq.quest
≔:=≕=:⩴::=

这里的 :=、=: 是数学排版符号,不会给 Typst 变量赋值。真正的代码变量需要使用 #let 定义。

3.3. 大小、序关系与整除

符号Typst 语法符号Typst 语法符号Typst 语法
<<>>≤<=
≥>=≮lt.not≯gt.not
≰lt.eq.not≱gt.eq.not⩽lt.eq.slant
⩾gt.eq.slant≪<<≫>>
⋘lt.triple⋙gt.triple≺prec
≻succ⪯prec.eq⪰succ.eq
⊀prec.not⊁succ.not∣divides
∤divides.not∥parallel∦parallel.not
⟂perp≍asymp≭asymp.not

例如 $a divides b$ 表示整除关系,$a parallel b$ 表示平行,$a perp b$ 表示垂直。

4. 集合、数系与逻辑

4.1. 常用数系

符号Typst 语法符号Typst 语法符号Typst 语法
ℕNNℤZZℚQQ
ℝRRℂCCℍHH
𝔽FFℙPP𝔼EE

通常用 ℕ、ℤ、ℚ、ℝ、ℂ 分别表示自然数、整数、有理数、实数和复数;ℍ 常表示四元数。自然数是否包含 0 因约定而异。FF、PP、EE 为双线体字母。

4.2. 集合关系与运算

符号Typst 语法符号Typst 语法符号Typst 语法
∈in∉in.not∋in.rev
∌in.rev.not∅emptyset∅nothing
⊂subset⊆subset.eq⊊subset.neq
⊄subset.not⊈subset.eq.not⊃supset
⊇supset.eq⊋supset.neq⊅supset.not
⊉supset.eq.not∪union∩inter
⋃union.big⋂inter.big⊎union.plus
⊔union.sq⊓inter.sq∖without
∁complement×times⊍union.dot

subset.neq 表示真子集。集合差写作 A without B,笛卡尔积写作 A times B。

$ A = { x in RR mid(|) x^2 <= 4 } $
$ A subset.eq RR, quad A without {0} $
$ union.big_(i=1)^n A_i subset.eq B $
𝐴={𝑥∈ℝ|𝑥2≤4}𝐴⊆ℝ,𝐴∖{0}⋃𝑖=1𝑛𝐴𝑖⊆𝐵

普通集合运算用 union、inter;带上下限的集合运算通常用大运算符 union.big、inter.big。

4.3. 命题逻辑、量词与推导

符号Typst 语法符号Typst 语法符号Typst 语法
¬not∧and∨or
⋀and.big⋁or.big⊕xor
∀forall∃exists∄exists.not
⊤top⊥bot∴therefore
∵because⊢tack.r⊬tack.r.not
⊨tack.rr⊭tack.rr.not⊣tack.l
⇒=>⇔<=>⇏arrow.r.double.not

tack.r 常用于语法推导,tack.rr 常用于语义满足关系。

$ forall x in RR, quad x^2 >= 0 $
$ exists x in ZZ : x^2 = 9 $
$ (P and Q) => P, quad not (P or Q) equiv (not P and not Q) $
∀𝑥∈ℝ,𝑥2≥0∃𝑥∈ℤ:𝑥2=9(𝑃∧𝑄)⇒𝑃,¬(𝑃∨𝑄)≡(¬𝑃∧¬𝑄)

5. 常用箭头

箭头使用 arrow 加点分修饰符命名:l、r、t、b 分别表示左、右、上、下,tr 表示右上;long 表示长箭头,double 表示双线箭头,bar 表示带端点竖线。修饰符只在对应变体存在时有效,不能任意组合。

5.1. 单线、长箭头与映射

符号Typst 语法符号Typst 语法
→arrow.r←arrow.l
↔︎arrow.l.r↑arrow.t
↓arrow.b↕︎arrow.t.b
↗︎arrow.tr↘︎arrow.br
↖︎arrow.tl↙︎arrow.bl
⟶arrow.r.long⟵arrow.l.long
符号Typst 语法符号Typst 语法
⟷arrow.l.r.long↦arrow.r.bar
⟼arrow.r.long.bar↤arrow.l.bar
↪︎arrow.r.hook↩︎arrow.l.hook
↣arrow.r.tail↢arrow.l.tail
↠arrow.r.twohead↞arrow.l.twohead
↛arrow.r.not↚arrow.l.not

映射的定义常写 f : A -> B,元素对应关系写 x |-> f(x)。带钩、带尾、双箭头等符号常分别表达嵌入、单射或满射。

5.2. 双线箭头与逻辑等价

符号Typst 语法符号Typst 语法
⇒arrow.r.double⇐arrow.l.double
⇔arrow.l.r.double⇑arrow.t.double
⇓arrow.b.double⇕arrow.t.b.double
⟹arrow.r.double.long⟸arrow.l.double.long
⟺arrow.l.r.double.long⇏arrow.r.double.not
⇍arrow.l.double.not⇎arrow.l.r.double.not

5.3. 波浪、循环、成对箭头与鱼叉

符号Typst 语法符号Typst 语法
⇝arrow.r.squiggly⇜arrow.l.squiggly
⟿arrow.r.long.squiggly⬳arrow.l.long.squiggly
⇢arrow.r.dashed⇠arrow.l.dashed
↻arrow.cw↺arrow.ccw
↷arrow.cw.half↶arrow.ccw.half
⇆arrows.lr⇄arrows.rl
⇉arrows.rr⇇arrows.ll
⇈arrows.tt⇊arrows.bb
⇀harpoon.rt⇁harpoon.rb
↼harpoon.lt↽harpoon.lb
⇌harpoons.rtlb⇋harpoons.ltrb

5.4. 箭头的键盘简写

符号Typst 语法符号Typst 语法符号Typst 语法
→->←<-↔<->
⟶-->⟵<--⟷<-->
↦|->↣>->↠->>
⇒=>⇔<=>⟹==>
⟸<==⟺<==>⤇|=>
⇝~>⟿~~>⇜<~
↢<-<↞<<-⬳<~~

5.5. 带文字的可伸缩箭头

在 stretch 上添加上下标,箭头会按标注宽度伸缩;limits 可强制把标注放到正上、正下方。给向量加箭头则使用 arrow(v),与两个对象之间的关系箭头有所区别。

$ f : X -> Y, quad x |-> x^2 $
$ A limits(stretch(->))^f B $
$ A limits(stretch(->))^"线性映射"_"可逆" B $
$ x_n limits(stretch(->))^(n -> oo) x $
𝑓:𝑋→𝑌,𝑥↦𝑥2𝐴→𝑓𝐵𝐴→可逆线性映射𝐵𝑥𝑛→𝑛→∞𝑥

6. 数学字体与字形

6.1. 直立、斜体与粗体

数学变量的拉丁字母和小写希腊字母通常默认斜体。upright、italic、bold 控制数学字形,能够嵌套;普通正文的加粗或字体设置不一定具有相同效果。

符号Typst 语法符号Typst 语法
𝑥xxupright(x)
𝐴italic(A)𝒗bold(v)
𝒗bold(italic(v))𝐀bold(upright(A))
𝜶bold(alpha)πupright(pi)

6.2. 衬线、无衬线、等宽、双线体与花体

符号Typst 语法符号Typst 语法
𝐴𝐵𝐶serif(A B C)𝘈𝘉𝘊sans(A B C)
𝙰𝙱𝙲mono(A B C)𝔸𝔹ℂbb(A B C)
𝒜︀ℬ︀𝒞︀cal(A B C)𝒜︁ℬ︁𝒞︁scr(A B C)
𝔄𝔅ℭfrak(A B C)𝔞𝔟𝔠frak(a b c)
𝘼bold(sans(A))ℝ=ℝbb(R) = RR

cal 是书法体,scr 是另一种手写体,frak 是哥特体。cal 与 scr 能否呈现不同字形取决于数学字体的支持;某些字体中两者相同。bb 可以用于字母,常见数系也可以直接写 NN、RR 等。

向量常用 bold(v),矩阵用 bold(A),集合族用 cal(F),李代数用 frak(g)。

6.3. 选择整套数学字体

需要切换整套公式字体时,对 math.equation 设置 text(font: ...)。用于数学的字体需要支持 OpenType MATH 表,普通中文字体或正文字体不能替代完整数学字体。

#show math.equation: set text(font: "New Computer Modern Math")
$ cal(F)(x) = integral_0^oo upright(e)^(-t) t^(x-1) dif t $
ℱ︀(𝑥)=∫0∞e−𝑡𝑡𝑥−1d𝑡

本地编译使用已安装的数学字体,或通过编译器的 --font-path 参数提供字体目录。其他数学字体包括 STIX Two Math、Libertinus Math。

6.4. 公式内的文字、单位与颜色

短说明用字符串,复杂说明用 #text[...]。单位通常用直立体;数学模式的 thin 可在数值与单位之间加入细空白。颜色可以通过正文代码函数局部设置。

$ v = 12 thin upright(m) / upright(s) $
$ x_"最大" = max_(i in I) x_i $
$ a + #text(fill: rgb("#b13b45"))[$b$] = c $
𝑣=12ms𝑥最大=max𝑖∈𝐼𝑥𝑖𝑎+𝑏=𝑐

7. 上下标、分式、根式与定界符

7.1. 上下标、分组与撇号

_ 引入下标,^ 引入上标;复杂内容用圆括号分组。分组用的圆括号在上下标和分式中通常不显示;需要可见括号时再包一层,或使用 lr。

符号Typst 语法符号Typst 语法符号Typst 语法
𝑥𝑖x_i𝑥2x^2𝑥𝑖2x_i^2
𝑥𝑖+1x_(i+1)𝑥𝑛+1x^(n+1)𝑎𝑖,𝑗a_(i,j)
𝑓′(𝑥)f'(x)𝑓″(𝑥)f''(x)𝑓‴(𝑥)f'''(x)
𝑥″x^primes(#2)(𝑥2)3(x^2)^3𝑥𝑦𝑧x^(y^z)

primes(#2) 也可显式生成一组双撇号,其中计数参数是代码整数;普通输入通常直接写 f''。左上、左下以及多个角上的标注由 attach 控制。

$ attach(upright(C), tl: 14, bl: 6) $
$ attach(A, tl: p, bl: q, tr: r, br: s) $
$ scripts(sum)_(k=1)^n a_k, quad limits(A)_i^j $
C614𝐴𝑠𝑟𝑞𝑝∑𝑘=1𝑛𝑎𝑘,𝐴𝑖𝑗

scripts 强制把标注放在右侧,limits 强制放在正上、正下方。

7.2. 分式、根式与二项式

符号Typst 语法符号Typst 语法
𝑎𝑏a / b𝑎𝑏frac(a, b)
𝑎+𝑏𝑐+𝑑(a+b) / (c+d)11+1𝑥frac(1, 1 + 1/x)
𝑥sqrt(x)𝑥2+𝑦2sqrt(x^2 + y^2)
𝑥3root(3, x)𝑥+1𝑛root(n, x + 1)
(𝑛𝑘)binom(n, k)𝑎/𝑏a slash b

在嵌套结构中可以使用 frac 明确分子和分母的边界。root(n, x) 的第一个参数是根指数,第二个参数是被开方的表达式。

$ x = (-b plus.minus sqrt(b^2 - 4 a c)) / (2 a) $
$ binom(n, k) = n! / (k! (n-k)!) $
𝑥=−𝑏±𝑏2−4𝑎𝑐2𝑎(𝑛𝑘)=𝑛!𝑘!(𝑛−𝑘)!

7.3. 括号、绝对值、范数与取整

成对的普通括号会按内部内容自动调整高度;lr 用于显式匹配或控制大小,mid 让组内的竖线随外层定界符一起伸长。

符号Typst 语法符号Typst 语法
(𝑎+𝑏)(a + b)[𝑎,𝑏][a, b]
{𝑎,𝑏}{a, b}⟨𝑥,𝑦⟩lr(chevron.l x, y chevron.r)
|𝑥|abs(x)‖𝑣‖norm(v)
⌊𝑥⌋floor(x)⌈𝑥⌉ceil(x)
(𝑎𝑏)lr((a/b))[𝑎𝑏]lr([a/b], size: #120%)
$ { x in RR mid(|) abs(x) < 1 } $
$ lr(chevron.l u, v chevron.r) = sum_(i=1)^n u_i v_i $
$ lr(\]a, b\[), quad lr([x^2 + 1] / 2 |)_0^1 $
{𝑥∈ℝ||𝑥|<1}⟨𝑢,𝑣⟩=∑𝑖=1𝑛𝑢𝑖𝑣𝑖]𝑎,𝑏[,[𝑥2+1]2|01

用反斜杠转义括号可阻止它参与自动匹配,例如 \(。需要统一固定大小时可设置 #set math.lr(size: 1em)。

8. 重音、向量标记与上下方标注

8.1. 帽子、横线、点与箭头

许多重音符号可以像函数一样调用,例如 hat(x)、dot(x)。作用于多个字母时会按内容宽度尝试伸缩,实际效果也受字体提供的字形限制。

符号Typst 语法符号Typst 语法
𝑥̂hat(x)𝑥̃tilde(x)
𝑥̄macron(x)𝑥̅dash(x)
𝑥̇dot(x)𝑥̈dot.double(x)
𝑥⃛dot.triple(x)𝑥⃜dot.quad(x)
𝑥́acute(x)𝑥̀grave(x)
𝑥̆breve(x)𝑥̌caron(x)
𝑥̊circle(x)𝑥̋acute.double(x)
𝑣⃗arrow(v)𝑣⃖arrow.l(v)
𝐴𝐵⃡arrow.l.r(A B)𝑣⃑harpoon(v)
𝐴𝐵𝐶̂hat(A B C)𝑥⃗accent(x, arrow)

accent(base, accent) 可显式指定重音。给 𝑖、𝑗 添加重音时,Typst 默认会移除它们的点;需要保留时可以指定 dotless: #false。

8.2. 上下横线与括注

符号Typst 语法符号Typst 语法
overline(z)underline(x + y)
𝑎+𝑏⏟𝑛underbrace(a+b, n)𝑎+𝑏⏞𝑛overbrace(a+b, n)
𝑎+𝑏⎵𝑛underbracket(a+b, n)𝑎+𝑏⎴𝑛overbracket(a+b, n)
𝑎+𝑏⏝underparen(a+b)𝑎+𝑏⏜overparen(a+b)
𝑎+𝑏⏡undershell(a+b)𝑎+𝑏⏠overshell(a+b)
$ underbrace(x_1 + x_2 + dots.c + x_n, n "项") $
$ overbrace(a + b, "已知") + c = 0 $
𝑥1+𝑥2+⋯+𝑥𝑛⏟𝑛项𝑎+𝑏⏞已知+𝑐=0

8.3. 约去项与取消线

cancel 画出约去项的斜线;inverted 翻转方向,cross 画出交叉线。

符号Typst 语法符号Typst 语法
cancel(x)cancel(x, inverted: #true)
cancel(x, cross: #true)cancel(x, angle: #30deg)
$ (a cancel(b)) / cancel(b) = a, quad b != 0 $

9. 求和、极限与微积分

9.1. 大运算符

符号Typst 语法符号Typst 语法符号Typst 语法
∑sum∏product∐product.co
⋃union.big⋂inter.big⨄union.plus.big
⋀and.big⋁or.big⨁plus.o.big
⨂times.o.big⨀dot.o.big⨆union.sq.big

_、^ 同样用于上下限。独立公式中大运算符通常更大,上下限的位置由运算符类型与排版样式共同决定。

$ sum_(k=1)^n k = n(n+1)/2 $
$ product_(k=1)^n k = n! $
$ union.big_(i in I) A_i, quad inter.big_(i in I) B_i $
∑𝑘=1𝑛𝑘=𝑛(𝑛+1)2∏𝑘=1𝑛𝑘=𝑛!⋃𝑖∈𝐼𝐴𝑖,⋂𝑖∈𝐼𝐵𝑖

9.2. 极限与最值

符号Typst 语法符号Typst 语法
lim𝑥→0𝑓(𝑥)lim_(x -> 0) f(x)lim𝑛→∞𝑎𝑛lim_(n -> oo) a_n
lim sup𝑛→∞𝑎𝑛limsup_(n -> oo) a_nlim inf𝑛→∞𝑎𝑛liminf_(n -> oo) a_n
sup𝑥∈𝐴𝑓(𝑥)sup_(x in A) f(x)inf𝑥∈𝐴𝑓(𝑥)inf_(x in A) f(x)
max𝑖∈𝐼𝑥𝑖max_(i in I) x_imin𝑖∈𝐼𝑥𝑖min_(i in I) x_i
$ lim_(x -> 0) (sin x) / x = 1 $
$ lim_(n -> oo) (1 + 1/n)^n = upright(e) $
$ lim_(x -> 0^+) f(x), quad lim_(x -> 0^-) f(x) $
lim𝑥→0sin𝑥𝑥=1lim𝑛→∞(1+1𝑛)𝑛=elim𝑥→0+𝑓(𝑥),lim𝑥→0−𝑓(𝑥)

9.3. 积分与微分符号

符号Typst 语法符号Typst 语法符号Typst 语法
∫integral∬integral.double∭integral.triple
∮integral.cont∯integral.surf∰integral.vol
⨍integral.dash∲integral.cont.cw∳integral.cont.ccw
ddifDDif𝜕partial
∇nabla∆laplace∞infinity

dif、Dif 是带数学间距与直立字形的微分记号;partial 是偏微分符号。oo 是无穷大的简便写法,也可使用 infinity。积分的上下限默认常在右侧,想放到正上、正下方可用 limits(integral)。

$ integral_a^b f(x) dif x $
$ integral.double_D f(x, y) dif x dif y $
$ integral.cont_C bold(F) dot dif bold(r) $
$ limits(integral)_0^1 x^2 dif x = 1/3 $
∫𝑎𝑏𝑓(𝑥)d𝑥∬𝐷𝑓(𝑥,𝑦)d𝑥d𝑦∮𝐶𝑭⋅d𝒓∫01𝑥2d𝑥=13

9.4. 导数、偏导数与向量微积分

$ (dif y) / (dif x) = f'(x) $
$ (dif^2 y) / (dif x^2) = f''(x) $
$ (partial f) / (partial x), quad (partial^2 f) / (partial x partial y) $
$ nabla f, quad nabla dot bold(F), quad nabla times bold(F) $
$ laplace f = (partial^2 f)/(partial x^2) + (partial^2 f)/(partial y^2) $
d𝑦d𝑥=𝑓′(𝑥)d2𝑦d𝑥2=𝑓″(𝑥)𝜕𝑓𝜕𝑥,𝜕2𝑓𝜕𝑥𝜕𝑦∇𝑓,∇⋅𝑭,∇×𝑭∆𝑓=𝜕2𝑓𝜕𝑥2+𝜕2𝑓𝜕𝑦2

10. 常用函数与自定义算子

10.1. 三角、反三角与双曲函数

符号Typst 语法符号Typst 语法符号Typst 语法
sin𝑥sin xcos𝑥cos xtan𝑥tan x
cot𝑥cot xsec𝑥sec xcsc𝑥csc x
arcsin𝑥arcsin xarccos𝑥arccos xarctan𝑥arctan x
sinh𝑥sinh xcosh𝑥cosh xtanh𝑥tanh x
coth𝑥coth xsech𝑥sech xcsch𝑥csch x
sinc𝑥sinc xtg𝑥tg xctg𝑥ctg x

10.2. 指数、对数、代数与概率算子

符号Typst 语法符号Typst 语法符号Typst 语法
exp𝑥exp xln𝑥ln xlog𝑥log x
lg𝑥lg xlog2𝑥log_2 xarg𝑧arg z
deg𝑝deg pgcd(𝑎,𝑏)gcd(a, b)lcm(𝑎,𝑏)lcm(a, b)
det𝐴det Adim𝑉dim Vker𝑓ker f
im𝑓im fhom(𝑉,𝑊)hom(V, W)id𝑉id_V
tr𝐴tr APr(𝐴)Pr(A)𝑎mod𝑛a mod n

内置文字算子使用直立体,并具有合适的算子间距。例如 sin x 通常比 "sin" x 更符合数学排版。mod 在同余式中可与括号组合:a equiv b quad (mod n)。

10.3. 定义自己的算子

秩、方差、协方差等名字可以用 op 定义;需要在独立公式中将上下标作为上下限时,设置 limits: true。

#let rank = math.op("rank")
#let Var = math.op("Var")
#let argmin = math.op("arg min", limits: true)
$ rank(A) <= min(m, n) $
$ Var(X) = EE[X^2] - EE[X]^2 $
$ argmin_(x in RR) (x - 3)^2 = 3 $
rank(𝐴)≤min(𝑚,𝑛)Var(𝑋)=𝔼[𝑋2]−𝔼[𝑋]2arg min𝑥∈ℝ(𝑥−3)2=3

单字母变量在数学模式中会被直接排版;如果希望引用代码中定义的单字母值,使用 #,例如 #let x = 3 后写 $#x + 1$。自定义的多字母函数名可以直接在数学模式中使用。

11. 向量、矩阵、行列式与分段函数

11.1. 向量与矩阵的基本输入

vec 用逗号分隔列向量的分量;mat 用逗号分列、分号分行。数学模式中的 vec 是列向量,给变量加向量箭头应写 arrow(v)。

符号Typst 语法符号Typst 语法
(𝑥𝑦)vec(x, y)[𝑥𝑦]vec(x, y, delim: "[")
(𝑎𝑏𝑐𝑑)mat(a, b; c, d)(1001)mat(1, 0; 0, 1)
$ bold(A) = mat(1, 2; 3, 4), quad bold(x) = vec(x_1, x_2) $
$ bold(A) bold(x) = vec(x_1 + 2 x_2, 3 x_1 + 4 x_2) $
$ bold(v)^upright(T) = mat(v_1, v_2, v_3) $
𝑨=(1234),𝒙=(𝑥1𝑥2)𝑨𝒙=(𝑥1+2𝑥23𝑥1+4𝑥2)𝒗T=(𝑣1𝑣2𝑣3)

11.2. 定界符、对齐、间距与增广线

delim: "[" 使用方括号,delim: "|" 使用竖线,delim: #none 隐藏外层定界符。用 align 控制单元格对齐,用 gap 或 row-gap、column-gap 调整间距,augment 添加增广分隔线。

$ mat(1, 2; 3, 4, delim: "[") $
$ mat(a, b; c, d, delim: "|") = a d - b c $
$ mat(1, 0, 2; 0, 1, 3, augment: #2) $
$ mat(-1, 20; 300, -4, align: #right, gap: #0.6em) $
[1234]|𝑎𝑏𝑐𝑑|=𝑎𝑑−𝑏𝑐(102013)(−120300−4)

augment: #2 在第二列后加竖线。复杂分块可传入字典,例如 augment: #(hline: 1, vline: 1),在第一行和第一列后分别添加分隔线。

11.3. 省略号与一般矩阵

符号Typst 语法符号Typst 语法符号Typst 语法
…dots.h⋯dots.c⋮dots.v
⋱dots.down⋰dots.up…dots
$ A = mat(
  a_(1,1), dots.h, a_(1,n);
  dots.v, dots.down, dots.v;
  a_(m,1), dots.h, a_(m,n);
) $
𝐴=(𝑎1,1…𝑎1,𝑛⋮⋱⋮𝑎𝑚,1…𝑎𝑚,𝑛)

11.4. 分段函数与方程组

cases 的每个参数是一行,& 可以对齐函数值和条件。reverse: #true 将括号放在右边,delim 改变括号类型,gap 调整行间距。

$ abs(x) = cases(
  x & "当" x >= 0,
  -x & "当" x < 0,
) $
$ cases(
  x + y &= 3,
  2 x - y &= 0,
) $
|𝑥|={𝑥当𝑥≥0−𝑥当𝑥<0{𝑥+𝑦=32𝑥−𝑦=0

11.5. 用代码生成二维数据

在普通代码中调用 math.mat 时,每一行应作为一个数组参数;在数学模式中可以使用参数展开,把计算出的二维数组传给 mat。

#let rows = ((1, 2), (3, 4))
$ mat(..#rows) $
$ mat(..#range(1, 10).chunks(3)) $
(1234)(123456789)

12. 几何、组合、数论与其他常见记号

12.1. 几何与角度

符号Typst 语法符号Typst 语法符号Typst 语法
∠angle∡angle.arc∟angle.right
°degree⟂perp∥parallel
△triangle□square○circle
⌀diameter∢angle.spheric∎qed
$ angle A B C = 60 degree $
$ A B perp C D, quad A B parallel E F $
$ triangle A B C tilde.op triangle D E F $
∠𝐴𝐵𝐶=60°𝐴𝐵⟂𝐶𝐷,𝐴𝐵∥𝐸𝐹△𝐴𝐵𝐶∼△𝐷𝐸𝐹

12.2. 组合、数论与复数

符号Typst 语法符号Typst 语法符号Typst 语法
𝑛!n!𝑛!!n!!(𝑛𝑘)binom(n, k)
𝑎∣𝑏a divides b𝑎∤𝑏a divides.not bgcd(𝑎,𝑏)gcd(a, b)
overline(z)|𝑧|abs(z)arg𝑧arg z
iupright(i)eupright(e)∞oo
$ a equiv b quad (mod n) $
$ z = a + b upright(i), quad overline(z) = a - b upright(i) $
$ upright(e)^(upright(i) theta) = cos theta + upright(i) sin theta $

12.3. 概率、统计与内积记号

$ Pr(A mid(|) B) = Pr(A inter B) / Pr(B), quad Pr(B) > 0 $
$ EE[X] = sum_(k=0)^oo k Pr(X = k) $
$ X tilde.op cal(N)(mu, sigma^2) $
$ hat(mu) = 1/n sum_(i=1)^n x_i $
$ lr(chevron.l psi mid(|) phi chevron.r) $
$ lr(| psi chevron.r) lr(chevron.l psi |) $
Pr(𝐴|𝐵)=Pr(𝐴∩𝐵)Pr(𝐵),Pr(𝐵)>0𝔼[𝑋]=∑𝑘=0∞𝑘Pr(𝑋=𝑘)𝑋∼𝒩︀(𝜇,𝜎2)𝜇̂=1𝑛∑𝑖=1𝑛𝑥𝑖⟨𝜓|𝜑⟩|𝜓⟩⟨𝜓|

13. 多行公式、对齐、编号与引用

13.1. 换行与对齐点

数学公式内用单个反斜杠 \ 换行,用 & 设置对齐点。把对齐点放在等号前,便可得到常见的分步推导。Typst 的写法不使用 LaTeX 的双反斜杠换行。

$
  (x + 1)^2 &= x^2 + 2 x + 1 \
             &= x(x + 2) + 1
$
(𝑥+1)2=𝑥2+2𝑥+1=𝑥(𝑥+2)+1

多个 & 会形成左右交替对齐的列;&& 常用于另起一组对齐区域,例如给推导添加说明。对齐点的数量与位置应在各行保持一致。

$
  3 x + y &= 9       && "已知" \
  3 x     &= 9 - y   && "移项" \
  x       &= 3 - y/3 && "两边除以 3"
$
3𝑥+𝑦=9已知3𝑥=9−𝑦移项𝑥=3−𝑦3两边除以 3

13.2. 公式编号、标签与交叉引用

用 math.equation(numbering: "(1)") 开启编号,在公式后放置 <标签>,再用 @标签 引用。supplement 控制引用前的名称,number-align 控制编号的位置。

#set math.equation(numbering: "(1)", supplement: [式])
$ a^2 + b^2 = c^2 $ <math-pythagoras>
由 @math-pythagoras 可求直角三角形的第三条边。
𝑎2+𝑏2=𝑐2

由 式 1 可求直角三角形的第三条边。

多行公式默认是一个公式块、共用一个编号;每行独立编号和引用时,分别使用多个公式块。

13.3. 对齐、长公式与跨页

独立公式默认居中,可以使用 #show math.equation: set align(left) 改为左对齐。长公式应在等号、加号或其他合理位置手动换行;公式默认不会自动按正文宽度重新断行。

#show math.equation: set align(left)
#show math.equation: set block(breakable: true)

独立公式默认不跨页。上面的第二条规则允许已经分成多行的公式块跨页;它不会自动拆开一个过长的单行表达式。

14. 数学间距、尺寸与进阶定制

14.1. 空白与显式间距

数学模式会根据符号类别自动安排间距,源码中连续输入空格通常不能精确控制距离。thin、med、thick、quad、wide 提供常用空白,#h(...) 可指定具体距离。

符号Typst 语法符号Typst 语法
𝑎𝑏a thin b𝑎𝑏a med b
𝑎𝑏a thick b𝑎𝑏a quad b
𝑎𝑏a wide b𝑎𝑏a #h(1em) b

命名空白可直接在公式中使用;#h(-0.1em) 能收紧局部距离。

14.2. 显示、行内与上下标尺寸

display、inline、script、sscript 分别强制使用独立公式、行内公式、上下标和更小一层上下标的排版样式。这些样式会同时影响分式、运算符和上下限,和单纯改变字号不同。

符号Typst 语法符号Typst 语法
𝑎𝑏display(a/b)𝑎𝑏inline(a/b)
𝑎𝑏script(a/b)𝑎𝑏sscript(a/b)
∑𝑖𝑎𝑖display(sum_i a_i)∑𝑖𝑎𝑖inline(sum_i a_i)

这些函数还接受 cramped: #true,用于收紧上标的垂直布局。要调整整条公式的文字大小,可以对 math.equation 设置 text(size: ...)。

14.3. 符号类别与自定义关系

class 决定内容按何种数学类别排版,影响周围间距和默认的标注位置。常见类别有 "normal"、"binary"、"relation"、"large"、"unary"、"opening"、"closing"、"fence"、"punctuation" 和 "vary"。

#let relates = math.class("relation", sym.diamond)
$ a relates b $
$ a class("binary", star) b $
𝑎◇𝑏𝑎⋆𝑏

在正文代码中写 math.class(...),在数学模式中可以直接写 class(...)。新定义的关系符号比简单插入一个图形更容易得到合适的数学间距。

14.4. 可伸缩符号与自定义函数

stretch 可以拉伸字体中支持伸缩的符号,适用于带长标注的箭头或等号。不是所有字符都能伸缩,尺寸也可能随字体提供的组合字形分级变化。

#let inner(u, v) = $lr(chevron.l #u, #v chevron.r)$
#let normsq(x) = $norm(#x)^2$
$ inner(u, v) = inner(v, u) $
$ normsq(x) = inner(x, x) $
$ H limits(stretch(=))^"定义" U + p V $
⟨𝑢,𝑣⟩=⟨𝑣,𝑢⟩‖𝑥‖2=⟨𝑥,𝑥⟩𝐻=定义𝑈+𝑝𝑉

函数体中的 #u、#v、#x 引用传入的内容。复杂样式可以通过 set、show 规则统一控制;重复使用的结构可以封装成自己的函数。

14.5. 可访问的数学描述

math.equation 的 alt 参数提供公式的自然语言描述,供辅助技术读取。

#math.equation(
  block: true,
  alt: "圆的面积等于圆周率乘以半径的平方。",
  $ A = pi r^2 $,
)
𝐴=𝜋𝑟2

15. 综合示例

15.1. 分析:泰勒展开与高斯积分

$ upright(e)^x = sum_(n=0)^oo x^n / n! $
$ integral_(-oo)^oo upright(e)^(-x^2) dif x = sqrt(pi) $
e𝑥=∑𝑛=0∞𝑥𝑛𝑛!∫−∞∞e−𝑥2d𝑥=𝜋

15.2. 线性代数:二次型与特征值

$ bold(x)^upright(T) bold(A) bold(x)
  = sum_(i=1)^n sum_(j=1)^n a_(i,j) x_i x_j $
$ det(bold(A) - lambda bold(I)) = 0 $
𝒙T𝑨𝒙=∑𝑖=1𝑛∑𝑗=1𝑛𝑎𝑖,𝑗𝑥𝑖𝑥𝑗det(𝑨−𝜆𝑰)=0

15.3. 概率:正态分布的密度

$ f(x) = 1 / (sigma sqrt(2 pi))
  exp(-(x - mu)^2 / (2 sigma^2)), quad sigma > 0 $
𝑓(𝑥)=1𝜎2𝜋exp(−(𝑥−𝜇)22𝜎2),𝜎>0

15.4. 优化:带条件的最小化

#let argmin = math.op("arg min", limits: true)
$ bold(x)^* = argmin_(bold(x) in RR^n)
  norm(bold(A) bold(x) - bold(b))^2 $
$ "约束:" quad bold(x) >= bold(0) $
𝒙∗=arg min𝒙∈ℝ𝑛‖𝑨𝒙−𝒃‖2约束:𝒙≥𝟎

16. 内置数学函数索引与语法对照

16.1. 数学模块的功能索引

公式内直接调用数学函数;普通代码模式中加 math. 前缀,例如 math.frac。命名符号由 sym 模块提供。

功能函数用途
公式equation独立与行内公式、编号、替代描述
上下标attach、scripts、limits多角标注与上下限位置
分式与组合frac、binom分数与二项式
根式sqrt、root平方根与一般根式
定界符lr、mid、abs、norm、floor、ceil括号匹配、绝对值、范数与取整
二维结构vec、mat、cases列向量、矩阵与分段表达式
重音与撇号accent、primes字母上方的标记与成组撇号
上下横线underline、overline内容下方与上方的横线
花括注underbrace、overbrace花括号与可选说明
方括注underbracket、overbracket方括号与可选说明
弧形括注underparen、overparen、undershell、overshell弧形与壳形括注
取消线cancel约去项与交叉取消线
字体样式upright、italic、bold直立、斜体与粗体
字体变体serif、sans、mono、bb、cal、scr、frak衬线、无衬线、等宽、双线、花体与哥特体
尺寸样式display、inline、script、sscript显示与上下标尺寸、紧凑样式
文字算子op自定义直立算子及其上下限
类别与拉伸class、stretch数学间距类别与可伸缩符号

hat、arrow、tilde 等重音调用使用符号本身;dif、Dif 是特殊微分记号;sin、lim、Pr 等是预定义文字算子。

16.2. 常用语法对照

需求Typst 写法说明
希腊字母alpha、Gamma不加反斜杠,大小写区分
分数frac(a, b) 或 a / b函数参数用逗号分隔
复杂上标x^(n+1)使用圆括号分组
可变括号lr((a/b))匹配括号通常会自动伸缩
粗体与双线体bold(A)、bb(R)使用数学字体函数
向量箭头arrow(v)vec 用于列向量
矩阵mat(a, b; c, d)逗号分列,分号分行
公式换行单个反斜杠 \用 & 设置对齐点
公式说明"当"、"否则"多个字母组成的文字需加引号
代码参数reverse: #true布尔值与长度等通过 # 进入代码
自定义算子op("rank")获得直立字形与算子间距

16.3. 官方参考资料