跳到正文
Mernyx
打开菜单

Mermaid,原生渲染

在你 Mac 上原生渲染的 Mermaid 编辑器

移动一个节点,Mermaid 源码跟着变。改一处文字,画布重新编译。

  • macOS 14.0+
  • 34 种图表族
  • PNG · SVG · PDF
  • AI 生成与修复(Pro)
Mernyx 窗口里打开着一张 Mermaid 流程图。左侧源码编辑器显示六行带语法高亮的代码,其中 C 节点被高亮;中间的画布显示渲染出来的图,选中的是「Let me think」那个菱形节点;右侧属性检查器显示同一个节点的显示名、填充、描边、文字颜色、宽度、不透明度和形状。
一份文档,三个视图。源码里高亮的那一个,就是画布上选中的那一个——也就是右边展开属性的那一个。

01

三栏改的都是同一份文档

在属性检查器里改一个颜色,源码里多一条样式规则,画布跟着重画。谁也不是谁的截图。

christmas-flow.mmd
flowchart TD
    A[Christmas] -->|Get money| B(Go shopping)
    B --> C{Let me think}
    C -->|One| D[Laptop]
    C -->|Two| E[iPhone]
    C -->|Three| F[Car]
    style C color:#ffffff,fill:#F4431E
  • 01

    编辑写回的是 Mermaid

    添加节点、连接两个、拖一条边、复制。画布写出的是标准 Mermaid 语法,不是旁挂的附属文件,也不是私有格式。

  • 02

    属性也是 Mermaid

    填充、描边、文字颜色、宽度和不透明度都写成普通的样式规则,属性检查器里会标明它来自直接样式,不是主题默认值。

  • 03

    一次撤销,不是三十次

    连续的属性编辑合并成一次文本撤销。⌥⌘I 整理文档时不碰注释和语句顺序。

02

没有 WebView。没有 JavaScript 桥。没有 Electron

大多数 Mermaid 工具是穿着桌面戏服的浏览器。Mernyx 原生绘制每一个节点,原生解算每一个布局。

由 AppKit 绘制

每个节点都是真正的视图,不是网页里假装成节点的 div。滚动始终顺滑,因为根本没有文档需要重新排版。

  • AppKit
  • NSView
  • CoreGraphics

原生计算布局

几何由专门的布局引擎算出来,不是由网页视图排出来的。Mernyx 并非没有依赖——它只是不是一个浏览器。

  • 布局引擎
  • 无 JavaScript

是文件,不是文档

在 Finder 里打开任意 .mmd 或 .mermaid 文件。用快速查看原地预览,不启动任何东西也能看到缩略图。

  • .mmd
  • .mermaid
  • 快速查看

03

34 种图表族

流程图、时序图、类图、状态图、ER 图、思维导图、C4、甘特图、旅程图、看板、xychart、ZenUML,还有 22 种——每一族都有自己的语法高亮关键字表、自己的布局和自己的编辑规则。

Flowchart

Sequence diagram

Class diagram

State diagram

ER diagram

Mindmap

Architecture diagram

Requirement diagram

Block diagram

Swimlane diagram

Agent flow diagram

Use case diagram

Pie chart

Gantt chart

Quadrant chart

Radar chart

Treemap

Kanban diagram

Packet diagram

Info diagram

Timeline

Sankey diagram

User journey

Venn diagram

C4 diagram

Cynefin diagram

Git graph

XY chart

Wardley map

Railroad diagram

ZenUML diagram

Event modeling diagram

Ishikawa diagram

Tree view

「覆盖」的意思是每一族都有一个能编译出非空场景的模板。不是指每一条语法和每个视觉细节都做完了。

流程图在画布上可以完整编辑。其他族支持其中越来越多的子集——能力矩阵列出了 34 个族各自能改什么,而 App 里这一族做不到的操作压根不摆出来。

04

图标是画出来的,不是拼出来的

Mermaid 里图标写作 fa:fa-user。GitHub 的 Mermaid 渲染器把这几个字母画出来,而不是图标本身。Mernyx 内置了 Font Awesome Free 字形,所以画布上显示的是图标——导出的 SVG 里带的是它的轮廓,而不是一个字体引用。

icons.mmd
flowchart LR
  A([fa:fa-user User]) --> B([fa:fa-server Server])
  B --> C([fa:fa-database Database])
一张从左到右的流程图,三个方框分别标着 User、Server 和 Database,每个标签前面都有一枚小小的 Font Awesome Free 图标:一个人、一台服务器机架和一个数据库圆柱。
Icons: Font Awesome Free, CC BY 4.0
  • 整套免费图标都在 App 里

    Font Awesome Free 7.3.1 随 Mernyx 一起发布——2,163 个图标,覆盖 solid、regular 和 brands 三种风格。不用安装也不用下载:字形在二进制文件里,你导出的文件同样不需要它们。

  • 导出带的是轮廓

    图标以路径的形式进入 SVG,而不是以字体名进入。在没装 Font Awesome Free 的机器上打开那个文件,图标依然在,并且跟着整张图一起缩放。

  • 节点本身可以是图标

    节点可以就是那个图标本身:@{ icon: “fa:user” } 会在字形外面画一个框,标签放在框外的一条色带上。同一套图标,多一种可选的形状。

两种写法都是 Mermaid 自己的——标签里的 fa:fa-user,节点上的 @{ icon: … }。没有 Mernyx 专属的东西要学,文件也还是普通的 .mmd。

05

描述一张图,或者修好那张编译不过的

两个入口,都跑在你自己的端点和自己的密钥上。模型只负责写 Mermaid 源码——编译、布局和绘制仍然由 Mernyx 来做,而且在你点应用之前,什么都不会写进你的文件。

用一句话生成一张图

在画布底部的输入栏里打字。Mermaid 源码会流式写进编辑器,画布边收边画,所以你能在它落盘之前逐行读完。Mernyx 负责编译结果;如果解析不过,错误会回传给模型让它重试。在你点「应用」之前,你的文件原封不动——而点错了,一次 ⌘Z 就撤回来了。

修好那张编译不过的

源码解析不过时,诊断栏会提供「用 AI 修复」。出问题的文件和它的诊断信息会发给你的模型,回来的是一份行级差异——所以在接受之前,你能确切看到改了哪里。只有当错误数真的变少了,「应用」才会出现,而这个判断来自引擎,不是来自模型。

  • 你的端点,你的密钥

    把 Mernyx 指向任意兼容 OpenAI 的端点——OpenAI、OpenRouter、DeepSeek、Groq、通义千问,或者通过 Ollama、LM Studio 跑在这台 Mac 上的模型。密钥存在你的 macOS 钥匙串里,请求从你的 Mac 发给你选的服务商。Mernyx 没有账号,中间也没有服务器。

  • 模型负责写,引擎负责画

    模型只返回 Mermaid 源码,别的什么都不返回。布局、配色和形状仍然由 Mernyx 的引擎决定,所以生成的图和手画的图出自同一个渲染器。

  • 先审,再应用

    两条路径最后都落到「应用」或「放弃」。放弃不会动文档,也不会进撤销栈;应用是一步替换,⌘Z 一步就能撤回来。

AI 生成和修复属于 Pro。免费版也能先把端点、模型和密钥配好——Pro 一解锁它们就开始工作。

这扇窗口还做的其他事

八件小事,没有一件配得上单独一章,但你一旦停用就会立刻发现少了它们。

导出

PNG、SVG 和 PDF,都从同一个场景直接产出,不用绕道浏览器的打印对话框——不过少数图元在位图导出里还是会略有差别。

整理文档

⌥⌘I 在不碰标记内容、注释和语句顺序的前提下,统一空白和流程图块的缩进。

源码 ↔ 画布联动

把光标放在源码的某个节点上,画布就高亮它——只有不在视野里时才滚动,而且绝不会抢走键盘焦点。在「设置 › 画布 › 联动」里开关。

快速查看与缩略图

直接在 Finder 里预览 .mmd 和 .mermaid 文件,支持滚动缩放、拖拽平移和系统浅色/深色。

示例与模板

14 个场景示例,外加全部 34 族各自的起手骨架,分成 5 个可搜索的分类。

键盘优先

菜单项按图表族和按选中情况分别启用,快捷键和菜单共用同一张绑定表。

带位置的诊断

每一族都把自己的关键字表和引擎给出的事实合并起来,所以带位置的诊断会被标成源码范围。

画布网格(可选)

默认关闭,而且永远不影响导出结果。

Mermaid 速查表

Mermaid 的语言分散在几十个族里各自成文。速查表覆盖的是核心那些:源码、它画出来的图,以及每条规则是干什么用的一行说明。

常见问题

Mernyx 渲染图表需要浏览器吗?

不需要——里面既没有 WebView,也没有 JavaScript 桥。几何由专门的布局引擎计算,每个形状都用 CoreGraphics 绘制。

哪些图表族可以在画布上编辑?

流程图在画布上的编辑能力最全:增删节点、连接与重连边、在边的中间插入节点、改样式、原地改名。其他族支持其中越来越多的子集,而改名几乎处处可用。能力矩阵列出了全部 34 个族各自能做什么——画布上的与源码里的——让你在买之前就能拿自己的图对一遍。App 里说的也是同一件事:某个族做不到的操作压根不摆出来;只是此刻不行的(正在编译、语法有错)那才会置灰,而不是悄悄什么也不做。

能用 Font Awesome 图标吗?

能——这是 Mermaid 自己的语法,Mernyx 画的是字形而不是字母。整套 Font Awesome Free 都打包进来了:2,163 个图标,覆盖 solid、regular 和 brands 三种风格,不用安装也不用下载。节点本身也可以就是那个图标,写成 @{ icon: “fa:user” }。有两样东西不在盒子里:Pro 专属的样式(fal: 和 fak:),以及 Font Awesome 之外的任何图标包。名字不在打包范围内时,会留下一个图标宽的空白,什么也不画——但绝不会让文档出错。

它能替我写图吗?

生成(⇧⌘G)把一句话变成 Mermaid 源码。它一边流式写进编辑器,画布一边画,Mernyx 负责编译结果,解析不过就把错误回传给模型重试。在你点「应用」之前,你的文件原封不动——而点错了,一次 ⌘Z 就撤回来了。它是一个表单加一次审阅,不是一个聊天窗口。

它能替我修语法错误吗?

本地没有一键修复——诊断是拿各族的关键字表去匹配的,背后没有确定性的重写规则。「用 AI 修复」(⌥⌘F)确实存在:它把出问题的源码发给你配置的 AI 端点,回来一份修正后的文档,由你审阅后再应用。

用 AI 时我的图会去哪里?

从你的 Mac 直接发到你配置的端点。Mernyx 没有账号,中间也没有服务器:密钥在你的 macOS 钥匙串里,请求发给你选的服务商,除此之外什么都离不开你的 Mac。这也是为什么没有按次计费这回事——token 是你自己的。AI 生成和修复属于 Pro,免费版可以先把端点、模型和密钥配好。

它会重写我的源码格式吗?

属性和标签的编辑只改动确切的源码范围。结构性的编辑会重组文档——先是节点,然后是边,然后是样式——这会统一空白,也不保留你原来的排布。⌥⌘I 是更温和的一条路:它保留标记内容、注释和语句顺序。

它需要什么?

macOS 14 或更高版本。它是原生 App,所以没有浏览器、运行时或插件要另外安装。

Mernyx 完成到什么程度了?

它是一件专注的工具,不是一件完成品——当前版本是 1.0.0,而且变化频繁。如果你的工作流依赖它,请在动手之前发邮件到 hi@mernyx.com,我会直接告诉你它合不合适。

怎么报告 bug 或提功能需求?

发邮件到 hi@mernyx.com。Mernyx 是一个人的项目,每封邮件都会有人读。

原生绘制

Mernyx 是一扇原生窗口:左边是源码,中间是真正的矢量画布,右边是属性检查器。