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