Typst 是一种全新的基于标记语言的排版系统，它的设计目标是与 LaTeX 一样强大，但更加易于学习和使用。相较于 LaTeX，Typst 内置了用于处理最常见格式化任务的标记语言，同时为其他所有任务提供了灵活的功能。

此外，Typst 还拥有紧密集成的脚本系统，可以轻松处理数学排版、参考文献管理等复杂任务。

在编译方面，Typst 采用增量编译技术，使得编译速度更快。即使出现错误，Typst 也会提供友好的错误提示，帮助用户快速定位和解决问题。

使用示例

基本使用

假设你需要写一份大学技术报告，其中包括正文、数学公式、标题和图片。首先，在 Typst 编辑器中创建一个新项目。编辑器中会有两个面板：源代码面板和预览面板。

输入文本内容，实时渲染预览页面：

要添加一个标题，输入=字符（= character）；要用斜体强调一些文本，在它两边加上下划线（_underscores_）：

若要添加新的段落，只需在两行文字之间加入一个空行。如果这个段落需要一个子标题，只需在=号上多加一个=号。=号的数量决定标题的嵌套级别。

使用+可以创建有序列表：

使用-号可以创建无序列表，还可以嵌套列表：

图片

Typst 支持多种图片格式，包括 PNG、JPEG、GIF 和 SVG。单击左侧边栏中的方框图标打开文件面板选择一张图片文件：

使用 Typst 的图像函数（#函数名）插入图片：

可以添加多个参数，使用逗号分隔。宽度参数是相对长度，确定图像将占页面宽度的 70%。我们也可以指定一个绝对值或百分比，比如 1cm 或 0.7in ：

使用 figure 函数来添加标题。这个函数将图形内容作为一个位置参数，一个可选的标题作为一个命名参数：

引用该图，需要在图形后面添加一个标签，将该标签与该图形唯一地关联。然后，可以通过在@符号后面跟上该名称来在文本中引用该图：

使用使用bibliography函数添加参考文献：

数学公式

Typst 内置了数学排版功能，并使用自己的数学符号。使用两个$ 符号将内容括起来就是一个数学表达式：

公式是内联排版的，与周围的文本在同一行。如果你想让它单独一行，你应该在它的开头和结尾插入一个空格：

可以看到 Typst 按原样显示了单个字母 Q、A、v 和 C，而将 rho 翻译为希腊字母。数学模式将始终按原样显示单个字母。但是，多个字母将被解释为符号、变量或函数名。如果想要在单个字母之间表示乘法，可以在它们之间放置空格。

如果您想要一个由多个字母组成的变量，可以用引号括起来：

使用求和符号，然后在下标和上标中指定求和的范围：

要为符号或变量添加下标，使用_字符，然后是下标。类似地，使用^字符添加上标。如果下标或上标由多个内容组成，则必须将它们括在圆括号中：

并非所有的数学结构都有特殊的语法。例如，要插入列向量，可以使用vec函数。在数学模式中，函数调用不需要以#字符开头：

另外，一些函数仅在数学模式中可用。例如，cal函数用于排版常用于集合的花体字母：

更多函数可参考：

安装

Typst 支持多种安装方式:

直接下载源代码

「macOS/Linux」: brew install typst

「Arch Linux」: pacman -S typst

「Void Linux」: xbps-install typst

使用 Rust 工具链

cargo install --git 

nix-shell -p typstnix run github:typst/typst -- --version

docker run -it ghcr.io/typst/typst:main

安装 Typst 后，可以像这样使用它：

# Creates `file.pdf` in working directory.typst compile file.typ# Creates PDF file at the desired path.typst compile path/to/source.typ path/to/output.pdf

还可以查看源文件并根据更改自动重新编译：

# Watches source files and recompiles on changes.typst watch file.typ

为项目添加自定义字体路径并列出它发现的所有字体：

# Adds additional directories to search for fonts.typst --font-path path/to/fonts compile file.typ# Lists all of the discovered fonts in the system and the given directory.typst --font-path path/to/fonts fonts# Or via environement variable (Linux syntax).TYPST_FONT_PATHS=path/to/fonts typst fonts