# LaTeX 轉 Typst

把 LaTeX 草稿轉成 Typst 原始碼，你可以檢查、儲存，或開啟成新專案。

當你想用 Typst 快速的本機工作流程，但素材已經在 LaTeX 裡時，LaTeX 轉 Typst 能讓你有個好的開頭。它會帶過常見的文件結構與數學式，其餘只有作者才能做的決定則留給你。

## 很適合

- 由標準章節、內文、清單、連結、表格與公式組成的論文或筆記；
- 測試現有草稿是否適合 Typst；
- 不必重新輸入就能搬移內容。

如果工作依賴出版社的文件類別、大量的巨集，或沒有對應 Typst 版本的套件，請繼續使用 LaTeX。轉換無法讓期刊接受另一種原始碼格式。

## 轉換原始碼

1. 開啟 **「LaTeX 轉 Typst」**，或執行 `/latex-to-typst`。
2. 貼上 LaTeX 原始碼。
3. 選擇 **「轉換」**。
4. 閱讀產生的 Typst，並檢視任何轉換備註。
5. 複製它、儲存 `converted.typ`，或建立 Typst 專案並編譯。

標準的 `\section`、段落、項目清單與行間公式，都會對應到各自的 Typst 寫法。像 `\newcommand{\model}{...}` 這樣的自訂指令，可能需要你手動改成 Typst 函式或變數。

## 檢查搬移結果

內建的 Pandoc 轉換在你的電腦上進行，並對產生的 Typst 套用相容性清理。它不會重現 LaTeX 套件的行為，也不會重現文件類別的視覺規則。

請檢查：

- 自訂巨集與環境；
- 公式語法與編號；
- 圖片路徑與圖說；
- 表格與交互參照；
- 參考文獻與引用樣式；
- 頁面幾何與字體排印。

請保留原始專案，直到 Typst 版本能順利編譯，並且你已經把完整的 PDF 逐頁比對過。如果要反向轉換，請使用 [Typst 轉 LaTeX](/docs/tools/typst-to-latex/)。

## 轉換整個專案

這個工具轉換的是你貼上的文字。如果是有多個檔案、圖片與參考文獻的 LaTeX 專案，請開啟該專案，並從命令面板執行 **「轉換為 Typst 專案」**。它會建立一個獨立的 Typst 專案、編譯它，並回報需要處理的地方。[Typst 專案](/docs/typst/#convert-a-latex-project-to-typst)會帶你逐步完成。如果只有單一公式，[方程式轉 Typst](/docs/tools/equation-to-typst/) 更快。