# 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/)。