# 方程式轉 Typst

把 LaTeX 數學式、用文字描述的方程式，或方程式圖片，轉成 Typst 數學式。

方程式轉 Typst 會把一條運算式轉成 Typst 數學式。可用於你熟悉 LaTeX 寫法的公式、只能用文字描述的公式，或是在螢幕截圖中的公式。

## 選擇正確的輸入

- **輸入方程式**可接受 LaTeX 數學式，例如 `\frac{a}{b}`、像 `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**。
:::
