用途:在 Obsidian 中创建可正确渲染、发布时不出问题的 Mermaid 图表,适用于流程图、时序图、ER 图,也可把 ASCII art 转换为 Mermaid,或修复 Obsidian 中的 Mermaid 渲染错误。
核心原则:简洁优先,用最少的节点和连接表达核心内容。节点最小化,可把顺序流程写进单个节点文本;连接最小化,只保留核心流向,节点建议不超过 5 个、避免连线交叉,复杂关系拆成多个简单图表。选择形式时,属性-值映射、比较、选项用表格,流程、过程、反馈环路用 Mermaid,简单顺序流可用内联 A → B → C。
关键规则:标签内不要使用 Markdown。Node["1. First"]、Node["Text<br/>More"]、Node["## Header"] 会分别报 Unsupported markdown: list 或 heading,应写成 Node[First]、Node[Text]。优先方形布局:flowchart LR 过宽、flowchart TB 过长,用 flowchart TB 配合 subgraph 内 direction LR 并可用 ~~~ 做隐形连接,使布局接近方形。标签要短,建议 15 字符以内,细节放在图外正文。subgraph 名称避免特殊字符,如用 subgraph Phase_One["Phase One"],而不是 subgraph "1. Phase One"。
用法示例:简单流程 flowchart TB 中 A[Start] --> B{Decision},B -->|Yes| C[Action],B -->|No| D[End];过程细节写在图外,如 Input、Process、Output 的说明;子图示例中 Frontend 内 UI --> API Call,Backend 内 Server --> Database,API --> Server。
应避免:标签中含 Markdown;flowsheet LR 中多个长名称导致过宽,在移动端或窄屏被截断。完成前检查:标签无 <br/>,无编号列表格式,使用 TB + subgraph 内 LR 的方形布局,标签都短,复杂细节移到图外,subgraph 名无特殊字符,并在 Obsidian 预览中测试渲染。