# 公式转 Typst

把 LaTeX 数学公式、用文字描述的公式或公式图片转换为 Typst 数学公式。

公式转 Typst 把一条表达式变成 Typst 数学公式。无论是你用 LaTeX 写出来的公式、只能用文字描述的公式，还是截图中的公式，都可以使用它。

## 选择合适的输入方式

- **输入公式**接受 `\frac{a}{b}` 这样的 LaTeX 数学公式、`e^(iπ) + 1 = 0` 这样的普通记法，或用文字写的描述。
- **公式图片**接受公式的 PNG、JPEG 或 WebP 图片。

当图片中还有段落或表格时，请使用[图片转 Typst](/docs/tools/image-to-typst/)。要预览 Typst 数学公式并将其导出为图片，请使用 [LaTeX 转图片](/docs/tools/latex-to-image/)的 Typst 模式。

## 转换表达式

1. 打开**公式转 Typst**，或运行 `/equation-to-typst`。
2. 输入表达式，或切换到**公式图片**并选择一张图片。
3. 选择**转换**。
4. 复制结果，或保存 `equation.typ`。
5. 添加与目标位置匹配的定界符：行内公式用 `$x$`，独立公式用 `$ x $`，即每个美元符号内侧各留一个空格。

例如：

```latex
\sqrt{x^2 + y^2} \le r
```

会变成：

```typst
sqrt(x^2 + y^2) <= r
```

## 转换的方式

输入的 LaTeX 数学公式会交给 Oleafly 自己的 LaTeX 转 Typst 数学公式翻译器，在你的设备上处理。打开 Typst 项目时，翻译器会使用该项目所用 Typst 版本能识别的符号名称。如果表达式包含翻译器不认识的命令，Oleafly 会改用内置的 Pandoc 转换整个表达式。

用文字写的描述或图片会先交给工具所用模型（除非你另选，否则是本地的 Ollama 模型）。模型写出 LaTeX，然后这段 LaTeX 以同样的方式转换。图片需要能够读图的模型。

## 插入之前先检查

结果只是表达式本身，没有定界符，也没有说明。请检查分组、分数、下标、上下限和运算符名称。你自己定义的命令，例如导言区中的 `\newcommand`，对两个转换器都没有意义：请先展开它们，或手动修正结果。

图片必须小于 20 MB。该工具转换的是记号，不检查数学内容。

:::tip[已经在用 Typst 写作？]
把 LaTeX 数学公式直接粘贴到 `.typ` 文件中，当 Oleafly 提供**粘贴为 Typst 公式**时选择它。要转换文件中已有的数学公式，请选中它，右键点击，然后选择**将 LaTeX 公式转换为 Typst**。
:::
