# Typst 转 Markdown

把 Typst 标记转为可移植的 Markdown，可以复制、保存，或作为 Markdown 项目打开。

Typst 转 Markdown 保留 Typst 草稿的文字和基本结构，舍弃页面设计。结果是纯文本，wiki、代码仓库或 Markdown 编辑器都能使用。

## 适用场景

- 写作内容比页面布局更重要；
- 你要把笔记或草稿迁移到 Markdown 系统；
- 合作者想要一份不含 Typst 的简单源码。

如果模板、`show` 规则或精确的页面设计是成果的一部分，请留在 Typst。

## 转换草稿

1. 打开 **Typst 转 Markdown**，或运行 `/typst-to-markdown`。
2. 粘贴一段 Typst 片段或完整文档，或选择 **加载示例**。
3. 选择 **转换**。
4. 阅读 Markdown 结果。
5. 复制它，保存 `converted.md`，或选择 **创建项目** 把它作为 Markdown 项目打开。

例如：

```typst
= Method
We minimize $L(theta)$ with two constraints.
- Bounded error
- Stable updates
```

会变成 Markdown 标题、带美元符号分隔公式的段落，以及无序列表。

## 需要再检查的地方

内置的 Pandoc 在你的设备上转换源码。标题、强调、链接、列表、代码和常见公式通常能顺利对应。Typst 的函数、`#let` 定义、`show` 和 `set` 规则、包，以及带自定义版面的图片则可能无法转换。

之后请检查公式分隔符、图片路径、脚注、引用和表格。如果要把整个 Typst 项目导出为 Markdown，请使用该项目的 **导出** 菜单，它能保留更多公式和引用。[导出与转换项目](/docs/export/)里有详细说明。

如果需要反向转换，请使用 [Markdown 转 Typst](/docs/tools/markdown-to-typst/)。如果要交给对方文字处理文档，请使用 [Typst 转 Word](/docs/tools/typst-to-word/)。
