Typst 语法演示模板
本文档展示了在 Tufted Blog Template 中写作时可能用到的所有 Typst 语法格式。每个功能都包含源代码和实际效果对照。原文来源于Tufted Blog Template 仓库。
1. 文章头部模板
每篇文章的标准开头：
#import "../index.typ": template, tufted
#show: template.with(lang: "zh")
= 文章标题可用参数：
lang- 语言代码："zh","en"title- 浏览器标签标题
2. 标题层级
代码：
= 一级标题 (H1)
== 二级标题 (H2)
=== 三级标题 (H3)
==== 四级标题 (H4)效果演示：
三级标题示例
四级标题示例
（一级和二级标题过大，此处用三四级演示）
3. 文本格式
3.1 基础格式
代码：
*粗体文本*
_斜体文本_
*_粗斜体_*
`行内代码`效果：
- 粗体文本
- 斜体文本
- 粗斜体
行内代码
3.2 装饰效果
代码：
#underline[下划线]
#strike[删除线]
#overline[上划线]
#highlight[高亮标记]效果：
- 下划线
删除线- 上划线
- 高亮标记
3.3 上标与下标
代码：
E = mc#super[2]
H#sub[2]O效果：
- 质能方程：E = mc2
- 水分子：H2O
3.4 颜色与样式
代码：
#text(fill: red)[红色文字]
#text(fill: blue)[蓝色文字]
#text(fill: green)[绿色文字]效果：11 注意：颜色在网页中可能不显示，在 PDF 导出时有效。
- 红色文字
- 蓝色文字
- 绿色文字
4. 列表
4.1 无序列表
代码：
- 第一项
- 第二项
- 嵌套项
- 更深嵌套
- 第三项效果：
- 第一项
-
第二项
-
嵌套项
- 更深嵌套
-
- 第三项
4.2 有序列表
代码：
+ 第一步
+ 第二步
+ 子步骤 A
+ 子步骤 B
+ 第三步效果：
- 第一步
-
第二步
- 子步骤 A
- 子步骤 B
- 第三步
4.3 术语列表
代码：
/ Typst: 一个现代化的排版系统
/ Tufted: 基于 Tufte 风格的模板效果：
- Typst
- 一个现代化的排版系统
- Tufted
- 基于 Tufte 风格的模板
4.4 混合列表
代码：
- 无序项
+ 有序子项 1
+ 有序子项 2
- 另一个无序项效果：
-
无序项
- 有序子项 1
- 有序子项 2
- 另一个无序项
5. 链接与导航
5.1 外部链接
代码：
#link("https://typst.app/")[Typst 官网]
#link("https://github.com/", "GitHub")效果：
5.2 内部链接
代码：
#link("/Blog/")[返回博客列表]
#link("/CV/")[查看简历]效果：
5.3 邮箱链接
代码：
#link("mailto:example@email.com")[发送邮件]效果：
5.4 文件链接
代码：
#link("sample.pdf")[下载 PDF 文件]
#link("../")[返回上级目录]效果：
6. 图片
6.1 基础图片
代码：
#image("../../imgs/tufted-duck-male.webp", width: 200pt)效果： 使用 #image("路径", width: 200pt) 插入图片。
6.2 带标题的图片
代码：
#figure(
image("../../imgs/tufted-duck-female-with-duckling.webp", width: 250pt),
caption: [凤头潜鸭母子]
)效果： 使用 #figure(image(...), caption: [标题]) 为图片添加标题。
6.3 边栏图片
代码：
#tufted.margin-note[
#image("../../Blog/2025-04-16-monkeys-apes/imgs/gorilla.webp")
]
#tufted.margin-note[
⬆️ 这是一只大猩猩
]效果：（查看右侧边栏） 
⬆️ 这是一只大猩猩
6.4 全宽图片
代码：
#tufted.full-width[#image("../../imgs/devices.webp")]效果： 使用 #tufted.full-width[#image("路径")] 实现全宽图片展示。
6.5 图片并排
代码：
#grid(
columns: 2,
gutter: 10pt,
image("../../imgs/tufted-duck-male.webp"),
image("../../imgs/gorilla.webp"),
)效果： 使用 #grid(columns: 2, gutter: 10pt, image(...), image(...)) 实现图片并排。
7. 表格
7.1 基础表格
代码：
#table(
columns: 3,
[*姓名*], [*年龄*], [*城市*],
[Alice], [25], [北京],
[Bob], [30], [上海],
)效果：
| 姓名 | 年龄 | 城市 |
| Alice | 25 | 北京 |
| Bob | 30 | 上海 |
7.2 Markdown 风格表格
代码：
#import "@preview/tablem:0.3.0": *
#tablem[
| *Name* | *Score* | *Grade* |
| :----: | :-----: | :-----: |
| Alice | 95 | A |
| Bob | 87 | B |
]效果：
| Name | Score | Grade |
|---|---|---|
| Alice | 95 | A |
| Bob | 87 | B |
8. 代码块
8.1 行内代码
代码：
使用 `print()` 函数输出内容。效果： 使用 print() 函数输出内容。
8.2 Python 代码块
代码：（四个反引号包裹）
效果：
def fibonacci(n):
if n <= 1:
return n
return fibonacci(n-1) + fibonacci(n-2)
print(fibonacci(10)) # 输出: 558.3 Rust 代码块
效果：
fn main() {
println!("Hello, Typst!");
}8.4 JavaScript 代码块
效果：
const greet = (name) => {
console.log(`Hello, ${name}!`);
};
greet('World');8.5 带标题的代码块
代码：
#figure(caption: "快速排序算法")[python def quicksort(arr): if len(arr) <= 1: return arr pivot = arr[len(arr) left = [x for x in arr if x < pivot] middle = [x for x in arr if x == pivot] right = [x for x in arr if x > pivot] return quicksort(left) + middle + quicksort(right)
]效果：
代码 1 快速排序算法
def quicksort(arr):
if len(arr) <= 1:
return arr
pivot = arr[len(arr) // 2]
left = [x for x in arr if x < pivot]
middle = [x for x in arr if x == pivot]
right = [x for x in arr if x > pivot]
return quicksort(left) + middle + quicksort(right)9. 引用块与提示框
需要导入：#import "@preview/theorion:0.4.1": *
9.1 引用块
代码：
#quote-box[
这是一段引用文字。可以包含 *粗体* 和 _斜体_。
]效果：
9.2 提示框 (Tip)
代码：
#tip-box[这是一个提示信息。]效果：
提示
这是一个提示信息。
9.3 注意框 (Note)
代码：
#note-box[这是一个注意事项。]效果：
注意
这是一个注意事项。
9.4 重要框 (Important)
代码：
#important-box[这是一个重要信息！]效果：
重要
这是一个重要信息！
9.5 警告框 (Warning)
代码：
#warning-box[这是一个警告信息！]效果：
警告
这是一个警告信息！
9.6 危险框 (Caution)
代码：
#caution-box[这是一个危险提示！]效果：
小心
这是一个危险提示！
10. 脚注与边栏
10.1 脚注
代码：
这是正文内容。#footnote[这是脚注，会自动显示在边栏中。]10.2 边栏注释
代码：
#tufted.margin-note[
这是边栏内容，可以放置任意元素。
]效果：（查看右侧边栏） 这是边栏内容，可以放置任意元素。包括公式 。
这段文字旁边有边栏注释 →
11. 数学公式
11.1 行内公式
代码：
质能方程 $E = m c^2$ 是物理学中最著名的公式之一。效果： 质能方程 是物理学中最著名的公式之一。
11.2 块级公式
代码：
$ f(x) = integral_0^infinity e^(-x^2) d x = sqrt(pi) / 2 $效果：
11.3 分数与根号
代码：
$ frac(a + b, c - d) = sqrt(x^2 + y^2) $效果：
11.4 求和与积分
代码：
$ sum_(i=1)^n i = frac(n(n+1), 2) $
$ integral_a^b f(x) d x $效果：
11.5 矩阵
代码：
$ mat(
1, 2, 3;
4, 5, 6;
7, 8, 9
) $效果：
11.6 向量
代码：
$ vec(x, y, z) $效果：
11.7 多行对齐公式
代码：
$
f(x) & = (x + 1)^2 \
& = x^2 + 2x + 1
$效果：
11.8 希腊字母
代码：
$ alpha, beta, gamma, delta, epsilon, theta, lambda, pi, sigma, omega $效果：
12. 参考文献
12.1 创建 .bib 文件
在文章目录下创建 refs.bib：
@book{knuth1984texbook,
title={The TeXbook},
author={Knuth, Donald E.},
year={1984},
publisher={Addison-Wesley}
}12.2 引用语法
代码：
根据 @knuth1984texbook 的描述...
#bibliography("refs.bib")说明： 使用 @key 格式引用，在文档末尾用 #bibliography() 显示列表。
12.3 样式选项
代码：
// 自定义标题和样式
#bibliography("refs.bib", title: "参考文献", style: "ieee")支持的样式：
"ieee"- IEEE 格式"apa"- APA 格式"chicago-author-date"- 芝加哥格式"mla"- MLA 格式
13. 交叉引用与标签
13.1 添加标签
代码：
== 我的章节 <my-section>
#figure(image("photo.webp"), caption: [示例图]) <fig-demo>13.2 引用标签
代码：
如 @my-section 中所述...
参见 @fig-demo...效果演示：
表 1 示例表格
| A | B |
| 1 | 2 |
如 “13. 交叉引用与标签” 所述，我们可以引用章节。也可以引用 表 1。
14. 分隔线与换行
14.1 分隔线
代码：
#html.hr()效果：
14.2 换行
代码：
第一行文字 \
第二行文字（使用反斜杠换行）效果： 第一行文字
第二行文字（使用反斜杠换行）
14.3 分段
代码：
第一段落
第二段落（空行分段）效果： 第一段落
第二段落（空行分段）
15. 特殊字符转义
代码：
\* // 显示星号 *
\_ // 显示下划线 _
\# // 显示井号 #
\$ // 显示美元符号 $
\@ // 显示 @ 符号效果：
- 星号：*
- 下划线：_
- 井号：#
- 美元符号：$
- At 符号：@
16. 嵌入 Markdown
代码：
#import "@preview/cmarker:0.1.8"
#import "@preview/mitex:0.2.6": *
#let scope = (
image: (source, alt: none, format: auto) => figure(image(source, alt: alt, format: format))
)
#let md-content = read("article.md")
#cmarker.render(md-content, math: mitex, scope: scope)说明： 可以将现有的 Markdown 文件嵌入到 Typst 文档中渲染。
17. 编程特性
17.1 变量定义
代码：
#let name = "Typst"
#let version = 0.12效果：
- 名称：Typst
- 版本：0.12
17.2 条件判断
代码：
#let is_typst = true
#if is_typst [
✅ 这是 Typst！
] else [
❌ 这不是 Typst。
]效果： ✅ 这是 Typst！
17.3 循环
代码：
#for i in range(1, 4) [
第 #i 次循环 \
]效果： 第 1 次循环
第 2 次循环
第 3 次循环
17.4 遍历列表
代码：
#for item in ("苹果", "香蕉", "橙子") [
- #item
]效果：
- 苹果
- 香蕉
- 橙子
17.5 自定义函数
代码：
#let greet(name) = [👋 Hello, #name!]
#greet("World")
#greet("Typst")效果：
👋 Hello, World!
👋 Hello, Typst!
17.6 文本替换
代码：
#show "旧文本": "新文本"
这里会把所有的旧文本替换为新文本。效果（本段使用替换规则）： 我爱 Typst！（Typst 被替换为 Typst）
常用包导入汇总
// 引用块与提示框
#import "@preview/theorion:0.4.1": *
// Markdown 风格表格
#import "@preview/tablem:0.3.0": *
// 嵌入 Markdown
#import "@preview/cmarker:0.1.8"
// LaTeX 公式兼容
#import "@preview/mitex:0.2.6": *
// 文献解析
#import "@preview/citegeist:0.2.0": load-bibliography
// 图表绑定
#import "@preview/lilaq:0.5.0" as lq完整文章示例
以下是一篇完整文章的模板代码：
#import "../index.typ": template, tufted
#import "@preview/theorion:0.4.1": *
#show: template.with(lang: "zh")
= 我的技术博客文章
== 引言
这是一篇关于 *Typst* 排版系统的介绍文章。#footnote[Typst 是新一代排版系统。]
#tufted.margin-note[
#image("imgs/logo.webp")
]
== 主要特性
Typst 具有以下优点：
+ 语法简洁
+ 编译速度快
+ 支持现代化布局
#tip-box[
推荐使用 VS Code 配合 Typst 插件进行写作。
]
=== 代码示例
python print(“Hello, Typst!”)
=== 数学公式
著名的欧拉公式：
$ e^(i pi) + 1 = 0 $
== 总结
Typst 是一个优秀的排版工具。
#bibliography("refs.bib")本模板最后更新：2026-01-18