Pele(kepano)调研摘要
By 陈成 · Published October 26, 2026
Obsidian 的 Mermaid 渲染器 Pele 是什么、社区反馈如何,对 Qoder 桌面端的 Mermaid 渲染意味着什么?
整理时间:2026-10-24 来源:X 书签(3 条)及评论、X 搜索、Reddit、Hacker News、pele.run 官网、GitHub
一句话
Pele 是 Obsidian CEO kepano 写的 Mermaid 图表渲染库:语法沿用 Mermaid,布局和渲染全部重写。号称比 mermaid.js 快 100–500 倍,体积小约 6 倍,没有依赖,颜色和字体用 CSS 变量控制。它会成为 Obsidian 1.15 的内置 Mermaid 渲染器,MIT 开源,Obsidian 之外的项目也能用。
基本信息
| 项 | 内容 |
|---|---|
| 作者 | kepano(Steph Ango,Obsidian CEO) |
| 仓库 | obsidianmd/pele,TypeScript,MIT,约 3.3k star / 99 fork(截至 10-24) |
| 官网 | pele.run、Playground(带 Mermaid 对比模式) |
| 发布 | 仓库 10-05 创建,10-17 公开发布,一周内发到 1.9.0(10-22) |
| 名字 | 取自夏威夷火山与火之女神 Pele [ˈpɛlɛ],跟球王贝利无关(HN 和推特上不少人一开始以为是) |
| 用法 | npm install pele,然后 render(mermaidText) 返回 SVG;浏览器和 Node 都能跑 |
核心卖点(官网数据)
| Pele | Mermaid.js | |
|---|---|---|
| 包体积(gzip) | 230 kB | 1.6 MB |
| 渲染耗时 | 0.05–0.3 ms | 6–82 ms |
| 直接依赖 | 0 | 23 |
| 小屏 | 重新排版(宽流程图会变成纵向) | 整体缩放 |
| 主题 | CSS 变量,改颜色不用重新渲染 | theme 配置 |
- 兼容性:支持 Mermaid 12.1.0 内置的全部图表类型(流程图、时序、类图、状态、ER、甘特、Git graph、Sankey、C4、Mindmap、Kanban、Wardley、Venn 等 30 多种)。ZenUML 等外部插件不支持。
- 刻意不兼容的地方:只沿用语法,不沿用布局,节点位置和连线路径都是自己的算法;Mermaid 的 themeVariables 不生效;不支持任意 HTML label;
click只能跳链接,JS 回调会被忽略。 - subgraph 方向独立:子图连到外部节点时仍保持自己的方向。HN 上有人说光这一点就值得换。
- 安全限制:源码长度、SVG 输出大小、边数都有上限(Security)。
- 图大时自动开启缩放和拖拽,也可以通过 API 强制开启。
kepano 的原帖与一周更新
1. 发布帖(10-17,67 万浏览,1.1 万赞) 链接
做 Obsidian 的过程中我一直觉得 Mermaid 太大、太慢、太难做主题。Pele 会成为下一版 Obsidian 的渲染器,但现在就可以用。
评论区要点:
- 能读取 Obsidian 主题的 CSS 变量,图表自动跟随主题。kepano 回复:“exactly”。
- @s_penhouet 把自己的 Obsidian→PDF 工具换成 Pele 后,Mermaid 渲染从 33 秒降到 1 秒,还去掉了 Node 和 headless Chromium 依赖。
- 有人质疑“100–500×”区间太宽,需要分场景测数据。kepano 回复:clone 仓库后跑
npm run bench:mermaid自己测。 - 问能否用在其他工具里:kepano 说本来就是为任意工具设计的,见 API 文档。
- 问 BPMN 2.0:kepano 回了 Mermaid 上游 issue #7699,意思是先等 Mermaid 语法支持。
2. 一周后更新(10-24) 链接
本周改进:
- 渲染更快
- 支持数学公式 resolver(KaTeX / MathJax / Temml 等)
- Sankey 图支持渐变
- 带 subgraph 的图连线交叉更少
- label 支持上下标、行内代码,以及 kbd、underline、ins、cite 等样式
kepano 说本来只想在 Obsidian 发版前收集一些 bug 报告,没想到会被这么快采用。他在评论区列出了本周接入 Pele 的项目:
- Obsidian 1.15、Grok Bot(@poteto)、Octarine、Outline、Sanity Engineering、Markdown Preview、Writer(writer.computer)、Inkdrop、Super Engineering
- 其他用户报告的还有:CorTeX(Corca)、JetBrains 的 Markdown Pro 插件,以及 Go 移植版 sketch(@_GauravGosain,已跟到 1.8.0,33 种图都能在终端里画成纯文本)
3. Obsidian 官方 1.15.0 early access:已向 Catalyst 会员开放,Mermaid 改用 Pele 渲染,最多快 500 倍,自动使用主题的颜色和字体。kepano 在 Reddit 上确认 Pele 会做成核心功能(不是社区插件),Obsidian Publish 也会同步支持。
衍生与“卷”出来的项目
- Ondine(@_jxom 的推,14.9 万浏览):“Mermaid 又被重写了,这次用 Rust”。宣称 200B runtime、约 50µs 渲染,比 Pele 小 1943 倍、快 2.8 倍。引用区大多在调侃“万物皆可 Rust 重写”,也有人追问为了这些数字砍掉了哪些语法。另据 @gicrisf,Ondine 是 Pele 的 Rust/WASM 移植,输出单色风格。这些数字的严肃程度存疑,作者语气明显带玩笑。
- Super Engineering(@superdoteng):把 Pele 的结果用 GPUI(纯 Rust)原生渲染,支持缩放和拖拽。
- sketch(Go 移植,见上),以及一个 Hugo 博客接入案例(r/gohugo → 博文)。
社区反馈
Reddit(r/ObsidianMD)
- 官方帖:2.7k 赞,147 条评论,绝大多数是好评,比如“Obsidian 快和 VLC 一样,属于真心对用户好的软件”,“专注核心功能,不追 AI 热点”。
- 为什么不去改进上游 Mermaid? kepano:Mermaid 既是语法也是渲染器,现在还“奇怪地”成了一个 AI 平台。它要兼顾的用例和向后兼容太多,目标和我们不同。Pele 想要的是简单、快、贴合 Obsidian。
- 为什么这么快?(另一帖)kepano:真正该问的是 Mermaid.js 为什么这么慢。Pele 的提速大多来自它不做的事,Mermaid 有 3 个布局引擎、23 个依赖,还有大量为向后兼容留下的旧代码。
- 有开发者在原生 Swift Mac 应用里接入,13 种图平均提速 18 倍。
- 用户想要的功能:图里能用
[[wikilink]]、做成可 WYSIWYG 编辑的思维导图、作为 Bases 的一种视图。 - 少量反对声音:“从没听人抱怨过 Mermaid 渲染,这帖子跟风夸得像发烧做梦”(帖子)。另有人问 Pele 以后怎么跟进 Mermaid 的语法更新。
Hacker News(596 分,63 评论)
- 主要痛点有两个。一是 Mermaid 布局差,复杂一点的图连线就乱。kepano 回应说正因如此,Pele 只跟语法、不跟布局。二是服务端渲染要起整个 headless Chromium,Pele 正好解决这个问题。
- 有人迁移文档站后表示布局比原来好,暗色模式也省了一堆 workaround。
- 吐槽:示例页对暗色模式不友好;官网顶部没放 GitHub 入口,开源仓库不好找。
- 也有人仍然喜欢 D2、Graphviz、TikZ,并提到 Mermaid 官方在“猛推 AI”。
- 多人指出“文本画图 + LLM 生成 + git 可 diff”这类工作流里,Pele 这种轻量渲染器很合适。
中文圈
- @vikingmute:介绍了体积(230kB vs 1.6MB)、改 CSS 变量换肤不用重新渲染、浏览器和 Node 通用。
- @RyanJ_KOL:换渲染器后布局会变,提醒对 AI 生成的流程图逐条核对连接关系和“是/否”分支标签是否对应。
我的看法
- 思路是只要语法,不要实现。Mermaid 语法已经是 Markdown 生态(和 LLM 输出)里画图的事实标准,但 mermaid.js 的实现太重。Pele 保留语法、重写布局和渲染,顺手解决了主题、响应式和服务端渲染三个问题。
- 采用速度快,原因在于真需要。一周内有几十个应用接入,还出现了 Go、Rust 移植版,说明“Markdown 编辑器里 Mermaid 太重”是很多人共同的问题。
- 风险:布局和 Mermaid 不一致,已有的图可能变样;跟进上游语法要长期投入;BPMN 这类需求只能等上游。它比较适合笔记、文档站、编辑器这类重视速度和主题一致的场景。
- 适合自己产品的话:要在 Markdown 里渲染 Mermaid,又在乎包体积、暗色主题或 SSR,Pele 现在基本可以直接替换 mermaid.js。Qoder 桌面端正是浏览器 SVG 场景,值得认真考虑替换(见下文)。
对 Qoder(桌面工作台)意味着什么?
分析对象:Qoder 桌面端(2026-10-26 版本),实测环境为 Node +
pele@1.10.0,用例取自 Qoder 自己的 e2e 测试图和组件示例
结论先行
Qoder 是 Electron + React,最终要的就是浏览器里的 SVG,正是 Pele 的目标场景。Pele 对 Qoder 是直接相关的,而且正好命中 Qoder 过去 10 天在 Mermaid 上投入的几乎每个问题。
现状:Qoder 怎么画 Mermaid
- 依赖:
mermaid@^11.16.0+@mermaid-js/layout-elk@0.2.2。 - 唯一 Owner:设计系统里的一个共享代码块组件,Mermaid 相关代码约 2.1k 行。Chat(Streamdown)、Workspace Markdown(CodeMirror widget)、App Plugin(单文件 IIFE)、组件展示页都走这一个组件,全屏和 JPG 导出复用同一份 SVG。
- 10-16 到 10-24 连续做了 4 个 ADR:
| 日期 | ADR | 要解决的问题 | 做法 |
|---|---|---|---|
| 10-16 | 模板复用与稳定块高 | Workspace 滚动时同一张图反复渲染(一轮滚动 43 次) | 64 条 / 8 MiB SVG 缓存、请求合并、取消、SVG ID 隔离 |
| 10-22 | qoder-flowchart-v1 渲染策略 |
想要 Codex Desktop 那种流程图风格 | 换 ELK 布局,16px 圆角、14px/600 字、60px 最小高度、开放箭头;插件 runtime 因此 +1.52 MB(总 4.97 MB) |
| 10-24 | ELK 原生 Worker | 首次滚到图时卡顿:ELK 的"Worker"其实在主线程跑 | 构建期替换 elkjs 构造器,Blob Worker、30s 超时、30s 空闲释放、8 MiB 投影预算 |
| 10-24 | 窄面板响应式方向 | 宽 LR 图在侧栏缩成看不清的缩略图 | 每图一个 Controller + ResizeObserver;用 O(V+E) 路径下界在 ELK 前判断是否改 TB;64px 滞回;原方向和 TB 两套缓存身份 |
- 做完之后的真实 Electron 数据(11 节点测试图,M4 Pro):冷态挂载到 SVG 约 155–200 ms;120 节点图在 Worker 下仍有 61–65 ms 长任务;切换暗色主题每张图要重算一次(主题签名进了缓存 key);流式输出期间不渲染。
现在和换成 Pele 之后的渲染链路:
flowchart LR
subgraph NOW[现在:mermaid.js + ELK]
direction TB
N1[读取设计 token 生成 themeVariables] --> N2[Mermaid 解析 + 主线程测字]
N2 --> N3[响应式预判:是否改 TB]
N3 --> N4[ELK 原生 Worker 布局]
N4 --> N5[主线程绘制 SVG]
N5 --> N6[(64 条 / 8 MiB SVG 缓存)]
end
subgraph PELE[换成 Pele]
direction TB
P1["render(source, maxWidth, autoDirection)"] --> P2["SVG,颜色是 var(--pele-*)"]
P2 --> P3[设计 token 映射到 --pele-*]
end
NOW -.->|同步,约 0.3 ms| PELE
N6 --> OUT[代码块外壳 / 全屏 / 复制 / JPG 导出]
P3 --> OUT
Pele 和这些问题一一对照
| Qoder 的问题 | Qoder 现在的做法 | Pele 的对应 | 实测 |
|---|---|---|---|
| 冷渲染慢、主线程长任务 | 原生 Worker + 生命周期 + 预算 | 同步渲染,不需要 Worker | 同一张 11 节点测试图 0.31 ms;120 节点 1.0 ms;300 节点 / 600 边 23 ms(Node,Pele 默认测宽器) |
| 窄面板看不清 | 响应式 Controller + 下界预判 + 滞回 + 双缓存身份 | 内置 responsive / maxWidth / autoDirection / directionBreakpoint |
测试图在 263 px 下自动变成 736×744 纵向;718 px 默认不翻转,设 directionBreakpoint: 900 后翻转 |
| 主题:读 token → themeVariables,换主题要重渲染 | 渲染前读取设计 token 生成 themeVariables,主题进缓存 key | SVG 里全是 var(--pele-*),把设计 token 映射到 --pele-* 即可,换主题不用重渲染 |
SVG 根节点自带 --pele-* fallback |
| 插件 runtime 体积 | Mermaid 3.45 MB + ELK 1.52 MB = 4.97 MB | 705 KB(gzip 263 KB) | 约为现在的 1/7 |
图源 classDef / style 优先 |
V1 只补未声明的默认值 | 支持 | 组件示例里的 fill/stroke/color、stroke-width:2px、stroke-dasharray:4 2、subgraph style 都保留 |
| 其他图类型 | 走 Mermaid 默认渲染,只有流程图有 V1 策略 | 33 种图共用同一套 CSS 变量主题 | — |
| 语法错误 | 失败后降级为源码 | PeleError,带 code / line / column |
flowchart LR\n A--> → syntax,3:1 |
| 安全 | securityLevel: strict、htmlLabels: false |
本来就不支持 HTML label,click 只跳链接,有源码 / 输出 / 边数上限 |
和 Qoder 现有的限制方向一致 |
换掉之后能删什么、还要留什么
- 可以删:ELK Worker 整套(客户端、生命周期、构建期替换)、响应式预判、流程图策略里的 ELK 注册和几何补丁,合计约 900 行;以及 ADR 里"上游升级必须重新验证模块替换和 Worker 协议"这条长期维护负担。
- 缓存可以大幅简化:渲染只要零点几毫秒,64 条 / 8 MiB 模板缓存和请求合并的必要性大大降低,主题也不用再进缓存 key。
- 还要留:代码块组件外壳、全屏、复制、JPG 导出、per-instance SVG ID 隔离。实测
idPrefix不会给节点和边的id加前缀(如L_A_B_0、Team),同一张图出现两次仍会撞 ID,现有的 SVG ID 重绑定还得用。 - 导出要小改:Pele 的颜色靠 CSS 变量,克隆出去的 SVG 脱离页面后会落到 Pele 默认色,导出前要把当前
--pele-*的计算值写到克隆的根节点上。 - 意外收益:渲染足够快,可以考虑流式输出时也实时出图(需要处理半截源码的语法错误,别闪烁)。
代价与风险
qoder-flowchart-v1的 Codex 风格会丢一部分。Pele 只沿用语法,布局和外观是它自己的;能调的是颜色、字体、字号、圆角(--pele-radius)和 CSS class,60px 最小高度、18px 水平余量、ELK 的 BRANDES_KOEPF 等参数没有对应。ADR 里这些值是用户确认过的,换 Pele 需要重新做一次视觉决策。- 刚做完的工作会被大面积替换。10-22 到 10-24 的 Worker、响应式预判都是为 mermaid.js 慢和不响应式打的补丁。这部分是沉没成本,但继续维护它也有成本。
- Pele 很年轻:10-17 才公开,一周内从 1.9.0 到 1.10.0,API 还可能变。需要锁版本,并让现有 e2e 兜底。
- 布局和 mermaid.js 不同:用户在 GitHub / 其他工具里看到的同一张图,在 Qoder 里会长得不一样。不过 Qoder 换了 ELK 之后本来就和默认 Mermaid 不一样,这一点影响不大。
- ADR 约束:流程图策略 ADR 规定"任何 Surface 展示 Mermaid 必须走共享组件,不得建立第二套布局"。所以只能整体替换,不能只让部分图走 Pele。好在 Owner 唯一,替换点集中在设计系统和插件 runtime 构建。
方案对比
| 方案 | 做法 | 收益 | 成本与风险 | 建议 |
|---|---|---|---|---|
| A. 保持现状 | 继续用 mermaid + ELK + Worker | 不动刚验收的东西,V1 风格完整 | 冷态 150–200 ms、大图长任务、换主题重算、插件 5 MB、长期维护 Worker 替换 | 🟡 只在视觉上不能接受 Pele 时选 |
| B. 整体换成 Pele | 图表组件的渲染后端换成 Pele,设计 token → --pele-*,directionBreakpoint 对齐现有 12/14 字号规则;删 ELK / Worker / 预判 |
快约 500 倍、体积约 1/7、换主题不重渲染、33 种图主题统一 | V1 视觉要重新确认;导出补 CSS 变量;需要重跑三个 Surface 的 Electron 回归 | ✅ 先做 spike,结果好就替换 |
| C. 只让非流程图或回退场景用 Pele | 流程图继续 mermaid,其他图走 Pele | 改动小 | 违反"不得建立第二套布局",两套依赖都要背,体积反而更大 | ❌ 不做 |
建议的 spike(1–2 天)
- 在设计系统内加一个内部开关,图表组件改用 Pele 的
render()(或mount()),保留外壳、全屏、导出、ID 隔离。 - 主题映射:背景、正文、次要文字、填充、边框、主色这几类设计 token 分别映射到
--pele-bg / fg / line / surface / border / accent,圆角设 16px,字号设 14px。 - 跑现有验收:浏览器形状测试和 Electron e2e(主会话、Workspace、插件三个 Surface);节点数和边数的断言能复用,几何断言需要按 Pele 重写。
- 用组件展示页的 Mermaid 示例并排截图对比 V1 和 Pele,在浅色和深色主题下让用户做视觉决策。
- 量插件 runtime 体积和冷态 mount→SVG,跟 ADR 里记录的 4.97 MB、155–200 ms 对比。
flowchart TD
S[内部开关接入 Pele] --> T[主题映射 + 圆角 16px / 字号 14px]
T --> E[跑浏览器形状测试和三个 Surface 的 Electron e2e]
E --> V[浅色 / 深色并排截图:V1 vs Pele]
V --> Q{视觉可以接受?}
Q -->|是| B[方案 B:整体替换,删除 ELK / Worker / 预判]
Q -->|否| A[方案 A:保持现状]
B --> M[对比插件体积和冷态 mount 到 SVG 的耗时]
参考链接
- 书签 1:kepano 发布帖 https://x.com/kepano/status/2111472054293913749
- 书签 2:kepano 一周更新 https://x.com/kepano/status/2113990622168367440
- 书签 3:jxom Ondine https://x.com/_jxom/status/2112320010081501186
- Obsidian 官方推 https://x.com/obsdmd/status/2111476648784830943
- Obsidian 1.15 EA https://x.com/obsdmd/status/2113392224155374018
- 官网 https://pele.run / API https://pele.run/api / 兼容性 https://pele.run/compatibility / Playground https://pele.run/playground
- GitHub https://github.com/obsidianmd/pele
- Reddit 官方帖 https://www.reddit.com/r/ObsidianMD/comments/1x8dp2r/pele_new_renderer_for_mermaid_diagrams_coming_in/
- Reddit 讨论 https://www.reddit.com/r/ObsidianMD/comments/1xaqlcg/pele_from_the_obsidian_team_mermaid_diagrams/
- Reddit 讨论 https://www.reddit.com/r/ObsidianMD/comments/1xbafpa/pele_finally_makes_mermaid_feel_like_2026_and_not/
- HN https://news.ycombinator.com/item?id=50132193
- Super Engineering https://x.com/superdoteng/status/2113337393948299582
- Ondine(gicrisf)https://x.com/gicrisf/status/2113447051740450929
- sketch Go 移植 https://x.com/_GauravGosain
- Hugo 接入 https://blog.nimendra.online/blog/hugo-mermaid-pele/