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