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