# Mermaid 转 LaTeX

尽可能把 Mermaid 流程图转为可编辑的 TikZ，其他类型的图表则在本地回退为图片。

Mermaid 转 LaTeX 让图表从几行易读的文字开始，最终出现在论文里。常见的流程图会变成可编辑的 TikZ，因此标签、线条样式和位置都可以保留在 LaTeX 源码中。

## 最佳用途

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

对于包含曲线图、专业领域记号或需要手工精确布局的发表级图片，请改用[图片与图表工具](/docs/figures-diagrams/)。不要指望每一种 Mermaid 图表类型都有忠实的 TikZ 对应物。对于 Typst 文档，[Mermaid 转 Typst](/docs/tools/mermaid-to-typst/) 会改写成 fletcher 代码。

## 转换流程图

1. 打开 **Mermaid 转 LaTeX**，或运行 `/mermaid-to-latex`。
2. 粘贴 Mermaid 源码，或加载示例。
3. 选择 **转换**。
4. 阅读结果上方的说明，了解你得到的是 TikZ 还是以图片为基础的 LaTeX 图片。
5. 复制或保存 `.tex` 源码以及生成的所有资源文件。

示例：

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

方向为 `TD`、`TB`、`BT`、`LR` 或 `RL`，并且只有基本节点和连线的常见流程图，会被确定性地转换为 TikZ。如果语法用到了没有安全 TikZ 对应关系的 Mermaid 功能，Oleafly 会在本地把图表渲染成 PNG，并返回一段 LaTeX 图片代码，而不是丢弃其中的关系。

## 检查图片

请按最终的栏宽编译。检查线条交叉、标签换行、对比度、字号和图表的阅读顺序。为无法看到图片的读者添加说明性的图注或文字替代。

转换在你的设备上运行。Mermaid 输入上限为 50,000 个字符。图片回退需要 `graphicx`；可编辑的 TikZ 需要生成的源码中列出的那些宏包。