# 視覺化 Typst 編輯器

直接以分割的寫作與預覽版面開始 Typst 專案。

視覺化 Typst 編輯器省去了建立空白專案的設定步驟。它會建立 Typst 文件，並把原始碼開在即時 PDF 預覽旁邊，所以從第一行開始，每次編輯的效果都看得到。

## 何時選擇這個工具

當你正在學習 Typst、要把一個小想法變成排版文件，或想同時看到原始碼與輸出時，請使用它。

如果螢幕空間有限，或你偏好從僅有編輯器的版面開始，請選擇 [Typst 編輯器](/docs/tools/typst-editor/)。兩個工具建立的是同一種專案，只有開啟時的版面不同。

:::note[這裡的「視覺化」是什麼意思]
這個工具開啟的是原始碼與預覽並排的分割工作區。如果想在隱藏標記的情況下編輯，請在任何 Typst 檔案中，把編輯器工具列從 **「程式碼」** 切換到 **「視覺化」**。標題、強調、清單、數學式、影像、表格與參照就會在原處顯示，游標所在的那一行則會顯示原始碼。
:::

## 開始寫文件

1. 開啟 **「設定 → 實驗功能 → LaTeX 工具」**。
2. 開啟 **「視覺化 Typst 編輯器」**，或執行 `/visual-typst-editor`。
3. Oleafly 會建立 **「未命名 Typst 文件」**，並以分割檢視開啟。
4. 為專案重新命名，並在 `.typ` 原始碼檔案中寫作。
5. 預覽沒問題後，匯出編譯好的 PDF。

試試這個小小的開頭：

```typst
= Results

The treatment group improved by *12%*.

$ integral_0^1 x^2 dif x = 1/3 $
```

開啟 **「自動編譯」** 後，內建的 Typst 引擎會在你輸入時更新預覽。你的原始碼仍然是一般的 `.typ` 檔案，可以在 Oleafly 之外編輯。

## 值得知道的事

- Typst 的編譯與 PDF 匯出都在本機執行。
- Typst 使用來自 Typst Universe 的套件，而不是 LaTeX 套件或 `tlmgr`。
- LaTeX 指令無法直接轉成 Typst 語法。請使用 [LaTeX 轉 Typst](/docs/tools/latex-to-typst/) 取得轉換後的起點。
- **「前往 PDF」** 以及在 PDF 中點擊，可以在原始碼與頁面之間跳轉，就像在 LaTeX 專案中一樣。

建立之後的專案編輯、檔案與匯出，請繼續閱讀[用 Typst 寫作](/docs/writing/typst/)。[Typst 專案](/docs/typst/)則涵蓋版本、套件與字型。