# HTML 轉 Typst

把語意化的 HTML 轉成獨立的 Typst 文件，可編輯、編譯，或變成專案。

HTML 轉 Typst 接收結構化的網頁標記，並給你 Typst 原始碼。標題、段落、強調、清單、連結和簡單的表格都會轉過來，所以你不必親手重建它們。

## 適用時機

- HTML 是你寫的，或你有權重複使用其內容；
- 頁面使用有意義的元素，例如標題、段落和清單；
- 你想要 Typst 中的文件結構，而不是頁面的視覺副本。

請貼上 HTML 本身。這個工具不會下載網頁、執行指令碼，也不會重建依賴 CSS 和 JavaScript 的版面。

## 轉換標記

1. 開啟 **HTML 轉 Typst**，或執行 `/html-to-typst`。
2. 貼上 HTML 片段或完整文件，或選擇**載入範例**。
3. 選擇**轉換**。
4. 閱讀產生的 Typst。
5. 複製它、儲存 `converted.typ`，或選擇**建立專案**，把它開啟成 Typst 專案。

例如：

```html
<h2>Method</h2>
<p>We compared <strong>three</strong> conditions.</p>
<ul><li>Control</li><li>Treatment</li></ul>
```

會變成 Typst 標題、含粗體文字的段落和項目符號清單。

## 哪些內容會保留下來

隨 Oleafly 附帶的 Pandoc 會在你的裝置上轉換語意結構。格線版面、響應式斷點、動畫和大部分 CSS 樣式在 Typst 中沒有對應，會被捨去。

之後請檢查連結、程式碼區塊、表格、巢狀清單和圖片參照。這個工具不會擷取遠端圖片或樣式表。若要連同圖片一起帶入 `.html` 檔案，請使用專案庫中的**匯入專案 → HTML 頁面**，它可以建立 Typst 專案，並把內嵌圖片擷取到 `assets/`。[匯入指南](/docs/import-project/)有相關說明。

若目的地是 LaTeX，請使用 [HTML 轉 LaTeX](/docs/tools/html-to-latex/)。
