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 配置

kepano 的原帖与一周更新

1. 发布帖(10-17,67 万浏览,1.1 万赞) 链接

做 Obsidian 的过程中我一直觉得 Mermaid 太大、太慢、太难做主题。Pele 会成为下一版 Obsidian 的渲染器,但现在就可以用。

评论区要点:

2. 一周后更新(10-24) 链接

本周改进:

kepano 说本来只想在 Obsidian 发版前收集一些 bug 报告,没想到会被这么快采用。他在评论区列出了本周接入 Pele 的项目:

3. Obsidian 官方 1.15.0 early access:已向 Catalyst 会员开放,Mermaid 改用 Pele 渲染,最多快 500 倍,自动使用主题的颜色和字体。kepano 在 Reddit 上确认 Pele 会做成核心功能(不是社区插件),Obsidian Publish 也会同步支持。

衍生与“卷”出来的项目

社区反馈

Reddit(r/ObsidianMD)

Hacker News(596 分,63 评论)

中文圈

我的看法

  1. 思路是只要语法,不要实现。Mermaid 语法已经是 Markdown 生态(和 LLM 输出)里画图的事实标准,但 mermaid.js 的实现太重。Pele 保留语法、重写布局和渲染,顺手解决了主题、响应式和服务端渲染三个问题。
  2. 采用速度快,原因在于真需要。一周内有几十个应用接入,还出现了 Go、Rust 移植版,说明“Markdown 编辑器里 Mermaid 太重”是很多人共同的问题。
  3. 风险:布局和 Mermaid 不一致,已有的图可能变样;跟进上游语法要长期投入;BPMN 这类需求只能等上游。它比较适合笔记、文档站、编辑器这类重视速度和主题一致的场景。
  4. 适合自己产品的话:要在 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

日期 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 两套缓存身份

现在和换成 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 现有的限制方向一致

换掉之后能删什么、还要留什么

代价与风险

  1. qoder-flowchart-v1 的 Codex 风格会丢一部分。Pele 只沿用语法,布局和外观是它自己的;能调的是颜色、字体、字号、圆角(--pele-radius)和 CSS class,60px 最小高度、18px 水平余量、ELK 的 BRANDES_KOEPF 等参数没有对应。ADR 里这些值是用户确认过的,换 Pele 需要重新做一次视觉决策。
  2. 刚做完的工作会被大面积替换。10-22 到 10-24 的 Worker、响应式预判都是为 mermaid.js 慢和不响应式打的补丁。这部分是沉没成本,但继续维护它也有成本。
  3. Pele 很年轻:10-17 才公开,一周内从 1.9.0 到 1.10.0,API 还可能变。需要锁版本,并让现有 e2e 兜底。
  4. 布局和 mermaid.js 不同:用户在 GitHub / 其他工具里看到的同一张图,在 Qoder 里会长得不一样。不过 Qoder 换了 ELK 之后本来就和默认 Mermaid 不一样,这一点影响不大。
  5. 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 天)

  1. 在设计系统内加一个内部开关,图表组件改用 Pele 的 render()(或 mount()),保留外壳、全屏、导出、ID 隔离。
  2. 主题映射:背景、正文、次要文字、填充、边框、主色这几类设计 token 分别映射到 --pele-bg / fg / line / surface / border / accent,圆角设 16px,字号设 14px。
  3. 跑现有验收:浏览器形状测试和 Electron e2e(主会话、Workspace、插件三个 Surface);节点数和边数的断言能复用,几何断言需要按 Pele 重写。
  4. 用组件展示页的 Mermaid 示例并排截图对比 V1 和 Pele,在浅色和深色主题下让用户做视觉决策。
  5. 量插件 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 的耗时]

参考链接

Read this report as Markdown · Cite it (BibTeX)