Sublime Text无法开发真正渲染Mermaid的插件，因其沙箱不执行JS、无WebView、插件API无法控制前端；所有方案均依赖调用mmdc CLI生成SVG/PNG，而非动态渲染。
别折腾了——Sublime Text 不适合开发 Mermaid 渲染插件，也不存在“属于自己的”可维护插件路径。 它的渲染沙箱不执行 JS，没有 WebView，插件 API 无法注入或控制前端运行时环境。所有所谓“自研插件”最终都得绕回调用 mmdc CLI 工具，而这不是插件逻辑，是系统命令调用。
为什么你写不了真正能渲染 Mermaid 的 Sublime 插件
Sublime 的插件系统基于 Python，但它的预览窗口（无论是内置还是通过 MarkdownPreview）本质是受限 HTML 片段渲染器，不加载外部 JS、不执行内联 <script></script>、不支持 document.createElement('div') 后挂载 Mermaid 实例。即使你写一个 Python 插件去生成 HTML 模板并嵌入 mermaid.min.js，浏览器策略和 Sublime 的沙箱机制也会让 mermaid.initialize() 失效，控制台报 mermaid is not defined 或静默失败。
- Sublime 插件无法访问或控制 WebView 的 JS 上下文
- 所有已知 Mermaid 支持方案（如 Mermaid Preview）都只是封装了
mmdc命令调用 + 文件 IO，不是“渲染”，是“生成 SVG/PNG” - 你无法在插件中动态加载远程
mermaid.min.js或 patchMarkdownPreview的 HTML 输出流
如果你坚持要“自己的插件”，实际能做的只有这三件事
所谓“开发插件”，在 Sublime 场景下只能是：监听保存、拼接命令、读取输出、写入临时文件。它不碰 Mermaid 解析，也不改渲染流程。
将任意网站转换为文件系统，自动抓取网站并将页面挂载为 Markdown 文件，可使用 grep、diff、cat 等标准 Unix 命令进行搜索、比较、读取和浏览。
- 用 Python 写一个
sublime_plugin.TextCommand，监听当前 buffer 是否为.md文件且含```mermaid块 - 提取代码块内容，写入临时
.mmd文件，再调用系统命令：mmdc -i temp.mmd -o temp.svg -t dark - 把生成的
temp.svg路径插入到当前 Markdown 文件末尾（或另存为 HTML），触发MarkdownPreview刷新
注意：mmdc 必须已安装且路径正确；Mermaid 语法错误会导致命令直接退出，插件不会帮你校验；缩进/中文标点/换行符都会让 mmdc 解析失败，返回空 SVG。
比写插件更省事的替代方案
与其花半天写个脆弱、不可调试、无法升级的“自制插件”，不如用现成链路：
- 在 Sublime 中编辑
.md，严格按```mermaid+graph TD格式写图 - 配置一个 Build System：
{ "cmd": ["mmdc", "-i", "$file", "-o", "${file_base_name}.html"], "selector": "text.html.markdown" } - 按
Ctrl+B直接生成 HTML，用浏览器打开——这才是稳定、可复现、无需维护的流程
真正的复杂点不在代码，而在环境一致性：Node.js 版本（≥18）、mmdc 权限（macOS 可能需 xattr -d com.apple.quarantine /usr/local/bin/mmdc）、Mermaid 语法与插件版本的错配（flowchart TD 在旧版 mmdc 中不识别，得降级写 graph TD）。
