# Typst 轉 HTML

不用建立專案，就能把 Typst 標記轉成含 MathML 公式的獨立 HTML。

Typst 轉 HTML 會把貼上的 Typst 轉成一個可在任何瀏覽器開啟的 HTML 檔案。公式以 MathML 寫成，所以讀者可以選取它們，輔助科技也讀得到。

## 適用於

- 簡短 Typst 文件或一組筆記的網頁版本；
- 需要在手機與窄螢幕上重新排版的內容；
- 你正在處理的某個章節的快速 HTML 版本。

它不會複製 PDF 的頁面設計。當精確的版面很重要時，請匯出 PDF。

## 轉換原始碼

1. 開啟 **「Typst 轉 HTML」**，或執行 `/typst-to-html`。
2. 貼上 Typst 片段或完整文件，或選擇 **「載入範例」**。
3. 選擇 **「轉換」**。
4. 複製 HTML 或儲存 `converted.html`，然後在瀏覽器中開啟。
5. 檢查標題、連結、公式、表格與影像。

例如：

```typst
= Result
For $x > 0$, the loss decreases.
```

會變成 HTML 標題與段落，行內公式則以 MathML 表示。

## 輸出包含什麼

內建的 Pandoc 會讀取 Typst，並在你的電腦上寫出獨立的 HTML 文件，其中包含 MathML 公式與它能嵌入的資源。

Pandoc 讀取的是 Typst 標記，而不是 Typst 的指令碼功能。`#let` 函式、`show` 規則、套件與計算出來的內容，可能會被省略或簡化。如果是整個 Typst 專案，請改用專案的 **「匯出」** 選單：它從 Typst 自己的輸出建立 HTML，能保留更多公式與參照。[匯出與轉換專案](/docs/export/)說明了各種選擇。

:::caution[無障礙 HTML 仍需審查]
MathML 與真正的標題是好的開始，但不是認證。在宣稱頁面無障礙之前，請先測試鍵盤順序、連結文字、影像說明、表格標頭與色彩對比。
:::

如果來源是 LaTeX，請使用 [LaTeX 轉 HTML](/docs/tools/latex-to-html/)。
