# Markdown 轉 Typst

把 Markdown 筆記轉成 Typst 原始碼，並在快速的本機寫作專案中開啟。

Markdown 轉 Typst 保留 Markdown 輕鬆的開頭，並在草稿準備好時，換上表達能力更強的排版系統。常見的結構與數學式會被帶過去，結果仍然是你可以隨意調整的純文字原始碼。

## 適用於

- 已經發展成報告、講義或論文的筆記；
- 需要更好頁面設計的 Markdown 草稿；
- 不必重新輸入內容就能試用 Typst。

不要只是為了嘗鮮而轉換。如果儲存庫、靜態網站或協作者預期使用 Markdown，它的可攜性可能比額外的版面控制更有價值。

## 轉換原始碼

1. 開啟 **「Markdown 轉 Typst」**，或執行 `/markdown-to-typst`。
2. 貼上 Markdown。
3. 選擇 **「轉換」**。
4. 檢查產生的 Typst。
5. 複製它、儲存 `converted.typ`，或建立 Typst 專案。

例如，Markdown 的標題、粗體文字、編號清單與以 `$` 分隔的數學式，都會變成對應的 Typst 寫法。轉換使用內建的 Pandoc，在你的電腦上進行。

## 之後要調整什麼

Markdown 有很多種方言。任務清單、原始 HTML、自訂指令、引用擴充語法與外掛語法，可能不會被帶過去。Typst 也需要你自己決定範本、參考文獻樣式、頁面幾何與可重複使用的函式。

請編譯新專案，並檢查：

- 標題階層與清單巢狀；
- 公式與程式碼區塊；
- 連結與影像路徑；
- 註腳與引用；
- 任何不屬於核心格式的 Markdown 擴充語法。

如果要投稿 LaTeX，請直接使用 [Markdown 轉 LaTeX](/docs/tools/markdown-to-latex/)。如果要回頭轉換，請使用 [Typst 轉 Markdown](/docs/tools/typst-to-markdown/)。如果想從空白的 Typst 工作區開始，請從[視覺化 Typst 編輯器](/docs/tools/visual-typst-editor/)或 [Typst 編輯器](/docs/tools/typst-editor/)著手。