---
title: "Pele"
author: "陈成"
author_url: "https://research.sorrycc.dev/@sorrycc"
question: "Obsidian 的 Mermaid 渲染器 Pele 是什么、社区反馈如何，对 Qoder 桌面端的 Mermaid 渲染意味着什么？"
url: "https://research.sorrycc.dev/@sorrycc/pele"
emoji: "🌋"
published: 2026-10-26T13:13:56Z
updated: 2026-10-26T13:13:55Z
version: 2
cite: "https://research.sorrycc.dev/@sorrycc/pele.bib"
---

# Pele（kepano）调研摘要

By [陈成](https://research.sorrycc.dev/@sorrycc) · 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](https://github.com/obsidianmd/pele)，TypeScript，MIT，约 3.3k star / 99 fork（截至 10-24） |
| 官网 | [pele.run](https://pele.run)、[Playground](https://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](https://pele.run/security)）。
- 图大时自动开启缩放和拖拽，也可以通过 API 强制开启。

## kepano 的原帖与一周更新

**1. 发布帖（10-17，67 万浏览，1.1 万赞）** [链接](https://x.com/kepano/status/2111472054293913749)

> 做 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 文档](https://pele.run/api)。
- 问 BPMN 2.0：kepano 回了 Mermaid 上游 issue #7699，意思是先等 Mermaid 语法支持。

**2. 一周后更新（10-24）** [链接](https://x.com/kepano/status/2113990622168367440)

本周改进：
- 渲染更快
- 支持数学公式 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 插件](https://plugins.jetbrains.com/plugin/33400-markdown-pro)，以及 Go 移植版 sketch（@_GauravGosain，已跟到 1.8.0，33 种图都能在终端里画成纯文本）

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

## 衍生与“卷”出来的项目

- **Ondine**（[@_jxom 的推](https://x.com/_jxom/status/2112320010081501186)，14.9 万浏览）：“Mermaid 又被重写了，这次用 Rust”。宣称 200B runtime、约 50µs 渲染，比 Pele 小 1943 倍、快 2.8 倍。引用区大多在调侃“万物皆可 Rust 重写”，也有人追问为了这些数字砍掉了哪些语法。另据 [@gicrisf](https://x.com/gicrisf/status/2113447051740450929)，Ondine 是 Pele 的 Rust/WASM 移植，输出单色风格。**这些数字的严肃程度存疑**，作者语气明显带玩笑。
- **Super Engineering**（[@superdoteng](https://x.com/superdoteng/status/2113337393948299582)）：把 Pele 的结果用 GPUI（纯 Rust）原生渲染，支持缩放和拖拽。
- **sketch**（Go 移植，见上），以及一个 Hugo 博客接入案例（[r/gohugo](https://www.reddit.com/r/gohugo/comments/1xdx5bn/trying_pele_as_my_hugo_blog_mermaid_renderer/) → [博文](https://blog.nimendra.online/blog/hugo-mermaid-pele/)）。

## 社区反馈

### Reddit（r/ObsidianMD）
- [官方帖](https://www.reddit.com/r/ObsidianMD/comments/1x8dp2r/pele_new_renderer_for_mermaid_diagrams_coming_in/)：2.7k 赞，147 条评论，绝大多数是好评，比如“Obsidian 快和 VLC 一样，属于真心对用户好的软件”，“专注核心功能，不追 AI 热点”。
- **为什么不去改进上游 Mermaid？** kepano：Mermaid 既是语法也是渲染器，现在还“奇怪地”成了一个 [AI 平台](https://mermaid.ai/)。它要兼顾的用例和向后兼容太多，目标和我们不同。Pele 想要的是简单、快、贴合 Obsidian。
- **为什么这么快？**（[另一帖](https://www.reddit.com/r/ObsidianMD/comments/1xaqlcg/pele_from_the_obsidian_team_mermaid_diagrams/)）kepano：真正该问的是 Mermaid.js 为什么这么慢。Pele 的提速大多来自它不做的事，Mermaid 有 3 个布局引擎、23 个依赖，还有大量为向后兼容留下的旧代码。
- 有开发者在原生 Swift Mac 应用里接入，13 种图平均提速 **18 倍**。
- 用户想要的功能：图里能用 `[[wikilink]]`、做成可 WYSIWYG 编辑的思维导图、作为 Bases 的一种视图。
- 少量反对声音：“从没听人抱怨过 Mermaid 渲染，这帖子跟风夸得像发烧做梦”（[帖子](https://www.reddit.com/r/ObsidianMD/comments/1xbafpa/pele_finally_makes_mermaid_feel_like_2026_and_not/)）。另有人问 Pele 以后怎么跟进 Mermaid 的语法更新。

### Hacker News（[596 分，63 评论](https://news.ycombinator.com/item?id=50132193)）
- 主要痛点有两个。一是 Mermaid 布局差，复杂一点的图连线就乱。kepano 回应说正因如此，Pele **只跟语法、不跟布局**。二是服务端渲染要起整个 headless Chromium，Pele 正好解决这个问题。
- 有人迁移文档站后表示布局比原来好，暗色模式也省了一堆 workaround。
- 吐槽：示例页对暗色模式不友好；官网顶部没放 GitHub 入口，开源仓库不好找。
- 也有人仍然喜欢 D2、Graphviz、TikZ，并提到 Mermaid 官方在“猛推 AI”。
- 多人指出“文本画图 + LLM 生成 + git 可 diff”这类工作流里，Pele 这种轻量渲染器很合适。

### 中文圈
- [@vikingmute](https://x.com/vikingmute/status/2111794162702114894)：介绍了体积（230kB vs 1.6MB）、改 CSS 变量换肤不用重新渲染、浏览器和 Node 通用。
- [@RyanJ_KOL](https://x.com/RyanJ_KOL/status/2111795208811847767)：换渲染器后布局会变，提醒对 AI 生成的流程图逐条核对连接关系和“是/否”分支标签是否对应。

## 我的看法

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

- 依赖：`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 之后的渲染链路：

```mermaid
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-*` 的计算值写到克隆的根节点上。
- **意外收益**：渲染足够快，可以考虑流式输出时也实时出图（需要处理半截源码的语法错误，别闪烁）。

### 代价与风险

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 对比。

```mermaid
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/
