Mermaid Link Navigator

Mermaid Link Navigator (Obsidian Plugin)

Mermaid Link Navigator is an Obsidian plugin that renders Mermaid flowcharts with clickable [[wikilink]] nodes. Ctrl/⌘+click a node to jump to its linked note. It also provides right-click visual editing of the flowchart (add / edit / delete nodes, change shapes, decision nodes with yes/no branches, parent-child links), canvas-style zoom and pan, a current-node locator, SVG/PNG export, and automatic link synchronization when notes are renamed.

Features: node-embedded [[note links]] · Ctrl/⌘+click navigation (plain click does not jump) · right-click visual editing that writes back to the note source · decision nodes (diamond) with yes-left / no-right layout · node shapes: rectangle / rounded / circle / diamond / hexagon / cylinder / double-border · canvas zoom & pan with auto-saved view state · select & locate current executing node · export full diagram as SVG / high-res PNG · dashed border when the target note does not exist (auto-create with configurable folder) · auto-sync links on note rename · outline-to-flowchart view · built-in Mermaid 11 (works offline) · desktop & mobile support.

Install: search Mermaid Link Navigator in Obsidian → Settings → Third-party plugins → Browse. Manual install: put main.js, manifest.json, styles.css from the latest release into .obsidian/plugins/mermaid-link-nav/.

Mermaid Link Navigator（Obsidian 插件）

在 Mermaid 流程图的节点里直接写 [[笔记链接]]，阅读模式下 Ctrl/⌘+单击节点即可跳转到对应笔记。支持右键可视化编辑流程图、画布式缩放平移、当前正在执行节点的选择与一键定位、导出 SVG / 高清 PNG。

功能

• 节点嵌入 [[笔记链接]]：支持 [[笔记]]、[[文件夹/笔记]]、[[笔记#标题]]、[[笔记|显示别名]]、[[#本笔记标题]]
• Ctrl/⌘+单击节点跳转（普通左键单击不跳转）：Alt+单击分屏、中键新标签页
• 右键可视化编辑（自动写回笔记源码）：
  • 添加节点（可指定上下游节点，笔记链接默认为节点名称）
  • 编辑节点名称和跳转链接
  • 删除节点（红色标注，入边自动指向出边）
  • 改变形状：矩形 / 圆角矩形 / 圆形 / 菱形 / 六边形 / 圆柱形 / 双边框
  • 选择父节点 / 选择子节点（点击图上任意已存在节点建立连线）
  • 设置为判断节点（菱形，是/否分支，是左否右布局）
  • 更换判断节点的【是】/【否】子节点
  • 断开父节点 / 断开子节点（删除普通连线，保留判断节点的【是/否】分支连线）
  • 更换位置（与另一节点交换显示内容）
• 选择当前正在执行的节点：点击图上方红色「选择当前正在执行的节点」按钮，屏幕中间提示后点击图上任一节点即选中；选中后出现绿色「🎯 定位当前正在执行的节点」按钮和灰色「取消选中当前正在执行的节点」按钮
• 一键定位当前节点：点击绿色「🎯 定位当前正在执行的节点」按钮，自动平移缩放并滚动页面到该节点位置
• 画布式缩放与平移：
  • 鼠标滚轮 / Ctrl+滚轮 / 触摸板双指捏合：以指针位置为中心缩放（上滚放大、下滚缩小）
  • 触摸板双指滑动 / 鼠标左键拖动 / 触屏单指拖动：平移
  • 缩放平移状态与滚动位置自动保存，重启后直接恢复到上次位置（不闪）
• 导出整张完整图：
  • 💾 导出 SVG：矢量格式，无限放大不失真
  • 🖼️ 导出 PNG：高清位图，纯白背景，默认存入库根目录「PNG图片/笔记名」文件夹
• 目标笔记不存在时，节点边框显示为虚线，点击自动新建笔记：可右键文件夹/笔记文件单独设置创建位置（文件夹内笔记继承，也可精确到单个笔记）
• 笔记重命名自动同步：重命名笔记后，mermaid 中对应的跳转链接自动更新
• 笔记大纲一键变流程图：命令面板执行「Mermaid Link Navigator：打开当前笔记的流程图视图」，自动读取标题与列表层级生成 flowchart
• 正常渲染 Mermaid 流程图 / 时序图等全部 Mermaid 图形（内置 Mermaid 11，不依赖网络）
• 主题自动跟随 Obsidian 明暗模式，可在设置中固定
• 兼容桌面端与移动端（手机端支持双指缩放、单指拖动平移）

安装

社区插件（推荐）

在 Obsidian「设置 → 第三方插件 → 浏览」中搜索 Mermaid Link Navigator，点击安装。

手动安装

1. 下载最新 release 的 main.js、manifest.json、styles.css
2. 放到你仓库的 .obsidian/plugins/mermaid-link-nav/ 目录下
3. 在 Obsidian「设置 → 第三方插件」中启用 Mermaid Link Navigator

想自行构建：在本目录执行 npm install，再执行 npm run build。

用法

推荐写法（节点标签用双引号包起来）

因为链接里含有 #、| 等符号，建议始终用双引号包裹标签：

```mermaid
flowchart LR
  A["[[首页|🏠 首页]]"] --> B(["[[项目总览]]"])
  B --> C{{"[[架构设计#数据库模块|数据库设计]]"}}
  B --> D["[[部署手册]]"]
```

渲染后：

• A 显示「🏠 首页」，Ctrl+单击打开《首页》
• B 显示「项目总览」，Ctrl+单击打开《项目总览》
• C 显示「数据库设计」，Ctrl+单击跳转到《架构设计》的「数据库模块」标题
• D 显示「部署手册」

支持的节点形状

矩形 []、圆角 ()、圆形 (())、菱形 {}、六边形 {{}}、圆柱 [()]、子程序 [[]]、旗帜 >]、平行四边形 [/ /] 等全部 flowchart 节点形状均可。

右键编辑

在流程图节点上右键，即可看到所有编辑选项。所有编辑操作都会自动写回笔记中的 mermaid 源码。空白处右键可添加新节点。

判断节点

右键节点 →「设置为判断节点」，依次点击选择【是】和【否】的子节点。判断节点显示为菱形，【是】分支自动排在左侧、【否】分支在右侧。后续可右键 →「更换【是】节点」/「更换【否】节点」单独修改。

选择并定位当前正在执行的节点

点击图上方红色「选择当前正在执行的节点」按钮，屏幕中间出现提示后点击图上任意节点即选中（按 Esc 取消）。选中后：

• 节点高亮显示
• 图上方出现绿色「🎯 定位当前正在执行的节点」按钮，点击后自动平移缩放并滚动页面到该节点
• 图上方出现灰色「取消选中当前正在执行的节点」按钮，点击取消选中

当前节点的选择跨设备同步（通过坚果云等同步插件同步状态文件），手机端选好节点后电脑端也能定位到同一节点。

导出图片

点击图上方「💾导出SVG」或「🖼️导出PNG」按钮，导出整张完整流程图（非当前缩放视口）。默认导出到库根目录的全局文件夹：SVG 存到「SVG图片/<笔记名>/」、PNG 存到「PNG图片/<笔记名>/」（文件夹不存在时自动创建，例如笔记“找工作流程”导出的 PNG 路径为 PNG图片/找工作流程/找工作流程.png）。也可在设置中填写固定文件夹，之后所有图片都导出到那里。

右键设置新笔记创建位置

点击流程图中不存在的链接时，会自动创建笔记。创建位置通过右键菜单配置，无需进设置页：

• 右键文件夹（左侧文件管理器）→「设置该文件夹的新笔记创建位置」→ 输入目标文件夹（可以是不存在的路径，创建笔记时自动建文件夹）；该文件夹内的笔记都生效；
• 右键笔记文件 →「设置该笔记的新笔记创建位置」→ 单独为这一个笔记配置（优先级最高）；已设置过的笔记右键可再选「取消该笔记的新笔记创建位置」恢复继承规则；
• 匹配规则：当前笔记单独配置（文件级）→ 所在文件夹逐级向上查找（子文件夹没设置就用上级文件夹的设置）→ 设置页「新笔记默认文件夹（全局）」→ Obsidian 默认位置；
• 输入框留空 = 恢复 Obsidian 默认位置。

设置项

命令面板中还提供「重新渲染当前笔记中的 Mermaid 链接图」命令，切换主题后可手动刷新。

注意事项

• 链接写在节点上才会绑定点击；写在连线标签（-->|文字|）上只会显示别名，不可点击。
• 一个节点里写多个链接时，第一个链接作为跳转目标，其余仅替换为显示文本。
• Ctrl/⌘+单击才会跳转，普通左键单击不跳转（避免误触）。

目录结构

mermaid-link-nav/
├── manifest.json        插件清单
├── main.js              构建产物（直接安装用）
├── styles.css           样式
├── src/
│   ├── main.ts          插件主逻辑：代码块渲染、跳转、右键编辑、设置页
│   ├── diagram-edit.ts  mermaid 源码编辑：添加/编辑/删除节点、改变形状、判断节点等
│   ├── parser.ts        mermaid 源码解析：节点 wikilink 与连线关系提取
│   ├── pan-zoom.ts      画布式平移缩放控制器
│   ├── focus-dom.ts     viewBox 缩放动画
│   ├── outline.ts       笔记大纲树解析 + 大纲转 mermaid flowchart
│   ├── outline-view.ts  「笔记流程图」ItemView
│   ├── edit-modal.ts    节点编辑弹窗
│   └── node-id.ts       从渲染后 DOM 还原源码节点 id
├── esbuild.config.mjs   构建脚本
├── tsconfig.json
└── package.json