转换与创建
Mermaid 转 Typst
把 Mermaid 流程图转为可编辑的 Typst fletcher 图表,语法无法对应时则给出渲染好的图片。
Mermaid 转 Typst 读取用几行 Mermaid 写成的流程图,并把它改写成 fletcher 图表。fletcher 是 Typst 的一个包,用节点和箭头绘制图表。标签、形状和箭头都保留在源码里,你可以随时编辑。
最佳用途
标题为“最佳用途”的部分它适合研究工作流、方法示意图、决策树,以及其他更看重连接关系而非图案的流程图。
如果要手工绘制图表,或在画布上调整转换后的图表,请使用图表编排器。如果是 LaTeX 文档,请使用 Mermaid 转 LaTeX。
转换流程图
标题为“转换流程图”的部分- 打开 Mermaid 转 Typst,或运行
/mermaid-to-typst。 - 粘贴 Mermaid 源码,或选择 加载示例。
- 选择 转换。
- 阅读结果下方的说明。它会告诉你得到的是可编辑的 fletcher 代码,还是渲染好的图片。
- 复制或保存
diagram.typ。当结果包含图片时,保存 ZIP 会把图片和源码一起保存。
示例:
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 版本”的部分导入行指定的 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 改为渲染图片的情况
标题为“Oleafly 改为渲染图片的情况”的部分有些 Mermaid 语法没有安全的 fletcher 对应写法:时序图等其他图表类型、子图、style 和 classDef 行,以及 a --> b --> c 这样的链式连线。这时 Oleafly 会在你的设备上绘制图表,保存为 assets/diagram.png,并返回一小段显示该图片的 #figure。图中的关系仍然可见,但这张图片不能再作为代码编辑。
转换在你的设备上运行。Mermaid 输入上限为 50,000 个字符。请按最终宽度编译结果,并检查标签换行、线条交叉和箭头方向。