# LaTeX 轉 HTML

建立含 MathML 公式的獨立 HTML，用於網頁閱讀、分享與無障礙工作。

LaTeX 轉 HTML 讓稿件在 PDF 之外有另一種樣貌。它會把文件結構轉成瀏覽器可以閱讀的 HTML，並把公式寫成 MathML，所以結果可以選取文字、會隨螢幕寬度重新排版，輔助科技也比讀取頁面圖片更容易理解。

## 適用於

- 論文、報告或一組筆記的網頁版本；
- 需要在手機與窄螢幕上重新排版的內容；
- 讀者應該能選取文字並檢視公式的審閱版本；
- 以無障礙為目標、可取代 PDF 的 HTML 版本。

它不是期刊 PDF 版面設計的忠實重現。如果目標是精確的分頁與列印版面，請使用 PDF 匯出。

## 轉換原始碼

1. 開啟 **「LaTeX 轉 HTML」**，或執行 `/latex-to-html`。
2. 貼上你要轉換的 LaTeX 原始碼。
3. 選擇 **「轉換」**。
4. 儲存 `converted.html`，並在瀏覽器中開啟。
5. 檢查標題、連結、公式、圖片、表格與參考文獻。

像這樣的章節：

```latex
\section{Result}
For $x > 0$, the loss decreases monotonically.
```

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

## 輸出包含什麼

內建的 Pandoc 流程會產生獨立的 HTML 文件，嵌入它能解析的資源，並用 MathML 表示公式。轉換在你的電腦上進行。

自訂的 LaTeX 巨集、出版社的文件類別、原始 TeX，以及直接在頁面上繪圖的套件，可能沒有對應的 HTML 寫法。參考文獻的呈現方式，也取決於提供給轉換器的來源與引用設定。

:::caution[無障礙 HTML 仍需審查]
MathML 與語意化標題能讓你有更好的起點，但不代表這個頁面通過任何無障礙標準。請測試鍵盤順序、連結文字、影像的替代文字、表格標頭、色彩對比，並用你的讀者會使用的輔助科技測試結果。
:::

如果需要標記式 PDF 的工作流程，請使用[預檢](/docs/preflight/)，並在把結果當作無障礙文件分享前，先閱讀它對 PDF/UA 的限制說明。如果來源是 Typst，請使用 [Typst 轉 HTML](/docs/tools/typst-to-html/)。