# Typst 轉 Markdown

把 Typst 標記轉成可攜的 Markdown，你可以複製、儲存，或開啟成 Markdown 專案。

Typst 轉 Markdown 保留 Typst 草稿的文字與基本結構，捨棄頁面設計。結果是 wiki、儲存庫或 Markdown 編輯器都能使用的純文字。

## 適用情境

- 文字內容比頁面版面更重要；
- 你要把筆記或草稿移進 Markdown 系統；
- 協作者想要不含 Typst 的簡單原始碼。

如果範本、`show` 規則或精確的頁面設計是成果的一部分，請繼續使用 Typst。

## 轉換草稿

1. 開啟 **「Typst 轉 Markdown」**，或執行 `/typst-to-markdown`。
2. 貼上 Typst 片段或完整文件，或選擇 **「載入範例」**。
3. 選擇 **「轉換」**。
4. 閱讀 Markdown 結果。
5. 複製它、儲存 `converted.md`，或選擇 **「建立專案」**，把它開啟成 Markdown 專案。

例如：

```typst
= Method
We minimize $L(theta)$ with two constraints.
- Bounded error
- Stable updates
```

會變成 Markdown 標題、含以 `$` 分隔數學式的段落，以及項目符號清單。

## 需要再看一遍的地方

內建的 Pandoc 會在你的裝置上轉換原始碼。標題、強調、連結、清單、程式碼與常見的數學式，通常都能順利對應。Typst 函式、`#let` 定義、`show` 與 `set` 規則、套件，以及自訂版面的圖片則不一定。

之後請檢查數學式分隔符號、影像路徑、註腳、參照與表格。若要把整個 Typst 專案匯出為 Markdown，請使用專案的 **「匯出」** 選單，它能保留更多公式與參照。[匯出與轉換專案](/docs/export/)有完整說明。

如果要反向轉換，請使用 [Markdown 轉 Typst](/docs/tools/markdown-to-typst/)。如果要交給文書處理軟體編輯，請使用 [Typst 轉 Word](/docs/tools/typst-to-word/)。
