# Mermaid 转 Typst

把 Mermaid 流程图转为可编辑的 Typst fletcher 图表，语法无法对应时则给出渲染好的图片。

Mermaid 转 Typst 读取用几行 Mermaid 写成的流程图，并把它改写成 fletcher 图表。fletcher 是 Typst 的一个包，用节点和箭头绘制图表。标签、形状和箭头都保留在源码里，你可以随时编辑。

## 最佳用途

它适合研究工作流、方法示意图、决策树，以及其他更看重连接关系而非图案的流程图。

如果要手工绘制图表，或在画布上调整转换后的图表，请使用[图表编排器](/docs/figures-diagrams/)。如果是 LaTeX 文档，请使用 [Mermaid 转 LaTeX](/docs/tools/mermaid-to-latex/)。

## 转换流程图

1. 打开 **Mermaid 转 Typst**，或运行 `/mermaid-to-typst`。
2. 粘贴 Mermaid 源码，或选择 **加载示例**。
3. 选择 **转换**。
4. 阅读结果下方的说明。它会告诉你得到的是可编辑的 fletcher 代码，还是渲染好的图片。
5. 复制或保存 `diagram.typ`。当结果包含图片时，**保存 ZIP** 会把图片和源码一起保存。

示例：

```mermaid
flowchart LR
  question[Research question] --> search[Search literature]
  search --> decide{Enough evidence?}
  decide -->|Yes| write[Write synthesis]
  decide -.->|No| search
```

方向为 `TD`、`TB`、`LR`、`BT` 或 `RL` 的 `flowchart` 或 `graph`，带有标签、连线标签、虚线或粗线连接以及常见的节点形状，会变成 fletcher 代码。结果以 fletcher 的 `#import` 行开头，后面是一个 `#diagram` 调用，每个方框对应一个 `node`，每个箭头对应一个 `edge`。

## fletcher 版本

导入行指定的 fletcher 版本能在你的 Typst 上运行。如果打开了 Typst 项目，Oleafly 会根据该项目的 Typst 版本来选择：Typst 0.13 及更高版本用 fletcher 0.5.8，Typst 0.12 用 0.5.5，更早的版本用 0.5.1。没有打开 Typst 项目时，使用 0.5.8。

Typst 会在使用 fletcher 的文档第一次编译时，从 Typst Universe 下载它。之后即可离线使用。

## Oleafly 改为渲染图片的情况

有些 Mermaid 语法没有安全的 fletcher 对应写法：时序图等其他图表类型、子图、`style` 和 `classDef` 行，以及 `a --> b --> c` 这样的链式连线。这时 Oleafly 会在你的设备上绘制图表，保存为 `assets/diagram.png`，并返回一小段显示该图片的 `#figure`。图中的关系仍然可见，但这张图片不能再作为代码编辑。

转换在你的设备上运行。Mermaid 输入上限为 50,000 个字符。请按最终宽度编译结果，并检查标签换行、线条交叉和箭头方向。
