Typst排版系统入门教程：从零开始掌握专业文档编写
项目地址: https://gitcode.com/GitHub_Trending/ty/typst Typst是一个基于标记的新型排版系统（Markup-based Typesetting System），它兼具LaTeX的强大功能和Markdown的易用性，通过简洁的语法和灵活的函数系统，让用户能够快速创建专业级文档。无论是学术论文、技术报告还是个人简历，Typst都能提供高效的排版解决方案。本文将带你从零开始，掌握Typst的核心功能和使用技巧。
Typst核心优势与安装指南
Typst的设计理念是"强大且易于学习"，相比传统排版工具，它具有以下显著优势：
- 简洁直观的语法：通过简短标记（如
=表示标题、_表示斜体）实现常见格式，减少记忆负担 - 灵活的函数系统：内置数百个函数覆盖排版需求，支持自定义逻辑扩展功能
- 即时编译反馈：增量编译技术实现毫秒级预览，大幅提升写作效率
- 原生数学排版：支持LaTeX风格的数学公式，语法更简洁且渲染速度更快
- 跨平台兼容性：支持Windows、macOS、Linux系统，提供在线编辑器和本地CLI工具
要开始使用Typst，可通过多种方式安装：
# macOS使用Homebrew安装
brew install typst
# Windows使用Winget安装
winget install --id Typst.Typst
# 从源码编译（需要Rust环境）
git clone https://link.gitcode.com/i/2821aecc9041c2568d8304d3a40de20d
cd typst
cargo build --release
安装完成后，通过typst --version命令验证安装是否成功。官方文档提供了完整的安装指南，包含各平台详细步骤和故障排除方法。
基础语法与文档结构
Typst使用纯文本文件（.typ扩展名）存储内容，通过简单标记即可实现复杂排版。让我们从一个基本示例开始：
// 设置页面大小和字体
#set page(paper: "a4", margin: 2cm)
#set text(font: "Serif", size: 11pt)
= 标题：我的第一篇Typst文档
作者：Typst用户
这是一段正文，支持*加粗*、_斜体_和`代码`格式。
+ 有序列表项1
+ 有序列表项2
- 嵌套无序列表项
- 嵌套无序列表项
== 二级标题
使用`==`创建二级标题，以此类推支持六级标题。
上述代码展示了Typst的核心语法元素：
- 注释：以
//开头，不影响最终渲染 - 设置规则（Set Rules）：通过
#set关键字配置全局样式，如页面尺寸、字体等 - 标题层级：使用1-6个
=符号表示不同级别标题 - 列表系统：
+创建有序列表，-创建无序列表，支持多层嵌套
文档结构遵循"一次编写，多处使用"的原则，通过导入功能可复用组件：
// 导入自定义模板
#import "templates/report.typ": report
// 使用模板包裹文档内容
#show: report.with(
title: "学术报告",
author: "张三",
date: "2023-10-01"
)
= 引言
本文使用Typst的模板功能实现统一格式...
文本格式化与样式定制
Typst提供丰富的文本格式化选项，满足不同场景的排版需求：
基础文本样式
通过简单标记即可实现常用文本效果：
// 文本样式示例
这是普通文本，支持*加粗文本*、_斜体文本_和`代码样式`。
还可以创建^上标^和~下标~，以及==高亮文本==。
// 引用块
> 这是一个引用块，适合展示重要内容或外部引用
> 支持多行文本和嵌套格式
// 水平分隔线
---
高级样式控制
使用text函数进行精细化样式调整：
#text(
size: 14pt, // 字体大小
weight: "bold", // 字重（bold/regular/light）
color: #ff5500, // 文本颜色
font: "Libertinus Serif", // 字体选择
)[自定义样式文本]
通过设置规则（Set Rules）可全局应用样式：
// 全局文本设置
#set text(
font: "Noto Serif SC", // 思源宋体（支持中文）
size: 12pt,
line-height: 1.5 // 行高
)
// 段落设置
#set par(
justify: true, // 两端对齐
first-line-indent: 2em // 首行缩进
)
Typst支持通过show规则实现内容重定义，例如自动替换特定文本：
// 将所有"Typst"替换为带图标的版本
#show "Typst": name => [
#image("icons/typst.svg", height: 0.8em) #name
]
数学公式与表格应用
数学排版基础
Typst内置强大的数学排版引擎，使用$符号包裹公式内容：
// 行内公式
流体力学基本方程 $F = \rho v^2 S C_d$ 描述了阻力与速度的关系。
// 块级公式（带编号）
$ F = G \frac{m_1 m_2}{r^2} $ <gravity>
// 引用公式
如公式@gravity所示，万有引力与距离的平方成反比。
常用数学结构示例：
// 分数与根号
$ \frac{n!}{k!(n-k)!} = \binom{n}{k} $
// 积分表达式
$ \int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $
// 矩阵表示
$ \begin{pmatrix}
a & b \\
c & d
\end{pmatrix} $
Typst的数学语法在保持与LaTeX兼容性的同时，做了诸多简化，如支持直接输入希腊字母（alpha→α）、自动识别多字母函数名等。完整的数学符号参考可在官方文档中查阅。
表格创建与样式
使用table函数创建表格，支持自动调整和样式定制：
#table(
columns: 3, // 列数
rows: 4, // 行数
align: center, // 对齐方式
stroke: 1pt, // 边框宽度
)[
// 表头
*姓名, *年龄, *职业,
// 表内容
张三, 30, 工程师,
李四, 28, 设计师,
王五, 35, 研究员
]
高级表格功能包括合并单元格、条件格式和动态内容：
#table(
columns: (1fr, 2fr, 1fr), // 按比例分配列宽
row-gutter: 8pt, // 行间距
cell-stroke: 0.5pt #ddd, // 单元格边框
)[
// 使用`..`合并单元格
..3[*项目进度表],
任务, 状态, 完成度,
需求分析, 已完成, 100%,
设计开发, 进行中, 60%,
测试部署, 未开始, 0%
]
文档组织与高级功能
交叉引用与目录
Typst提供完善的引用系统，支持标题、图片、表格等元素的交叉引用：
// 为章节添加标签
= 研究方法 <method>
// 在文档中引用
如第@method节所述，本研究采用混合研究方法...
// 生成目录
#outline() // 默认样式
#outline(
title: "目录", // 自定义标题
depth: 3, // 显示层级
numbering: "1.1" // 编号格式
)
图片与浮动元素
使用image函数插入图片，支持多种格式和缩放控制：
#figure(
image("figures/results.png", width: 80%), // 图片路径和宽度
caption: [实验结果可视化：不同参数对性能的影响], // 图片标题
label: "results" // 标签（用于引用）
)
通过place函数控制元素位置：
#place(
position: top-right, // 右上角
float: true, // 浮动布局
image("logo.png", height: 3cm)
)
模板与复用
将常用格式封装为模板，实现文档风格统一：
// 定义论文模板（保存为paper.typ）
#let paper(title, author, content) = [
#set page(paper: "us-letter", margin: 2.5cm)
#set heading(numbering: "1.1")
#align(center)[
#text(20pt, weight: "bold")[#title]
#v(12pt) // 垂直间距
#author
]
#v(24pt)
#content
]
// 使用模板（在主文档中）
#import "paper.typ": paper
#show: doc => paper(
title: "基于Typst的学术论文排版研究",
author: "Typst用户",
content: doc
)
= 引言
本文探讨了Typst在学术排版中的应用优势...
Typst Universe社区提供了大量免费模板，涵盖简历、论文、演示文稿等多种场景，可直接下载使用或作为自定义模板的参考。
实战案例：学术论文排版
下面通过一个完整案例展示如何使用Typst创建符合学术规范的论文：
// 1. 设置全局样式
#set page(
paper: "a4",
margin: (top: 3cm, bottom: 2cm, left: 3cm, right: 3cm),
header: align(right)[#page-number], // 页眉页码
footer: align(center)[论文标题] // 页脚标题
)
#set text(
font: "Libertinus Serif",
size: 11pt
)
#set heading(
numbering: "1.", // 标题编号格式
level: 3 // 最大编号层级
)
// 2. 标题与作者信息
#align(center)[
#text(18pt, weight: "bold")[
基于深度学习的图像识别研究进展
]
#v(12pt)
#grid(columns: 2)[
张三 \ 计算机科学系 \ zhang@university.edu,
李四 \ 人工智能研究所 \ li@university.edu
]
#v(24pt)
*摘要* \
本文综述了深度学习在图像识别领域的最新研究进展，分析了卷积神经网络、循环神经网络等模型的应用特点，并探讨了该领域面临的挑战和未来发展方向。
]
// 3. 正文内容
= 引言
图像识别是计算机视觉领域的核心任务之一，旨在使计算机能够理解图像内容...
== 相关工作
早期图像识别方法主要基于手工特征提取，如SIFT[#lowe2004sift]、HOG[#dalal2005hog]等算法...
= 理论基础
卷积神经网络（CNN）是图像识别的常用模型，其基本结构包括卷积层、池化层和全连接层：
$ f(x) = \sigma(W \ast x + b) $ <cnn公式>
其中$ \ast $表示卷积操作，$ \sigma $为激活函数...
// 4. 参考文献
#bibliography("refs.bib")
上述代码展示了学术论文的典型结构，包括样式设置、作者信息、摘要、章节内容、公式和参考文献等元素。通过分离内容与样式，Typst使文档维护和格式调整变得简单高效。
总结与资源推荐
通过本文的介绍，你已经掌握了Typst的基本使用方法和核心功能。作为一款新兴的排版系统，Typst正在快速发展，社区生态不断完善。以下资源可帮助你进一步提升Typst技能：
- 官方文档：完整教程和API参考
- 社区模板：Typst Universe提供大量免费模板
- 示例代码：项目仓库的测试用例包含丰富示例
- 开发工具：支持VS Code、Neovim等编辑器的插件，提供语法高亮和实时预览
Typst的设计理念是"让排版回归写作本身"，通过简化格式控制，让用户专注于内容创作。无论你是学生、研究人员还是技术作家，Typst都能帮助你更高效地创建专业文档。现在就尝试使用Typst，体验现代排版系统带来的便捷与乐趣吧！
提示：Typst团队活跃在GitHub上，欢迎提交issue和PR参与项目开发，或通过Discord社区与其他用户交流经验。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
