Qoder Web 端知识中心不支持 Mermaid 渲染是平台已知限制，非个人配置问题。 该问题在阿里云开发者社区已有用户反馈，核心原因是 Web 端展示层未集成 Mermaid.js 渲染引擎，导致图表只能以原始代码文本形式展示。
问题本质
Mermaid 并非标准 Markdown 语法，其图表渲染依赖运行环境加载 mermaid.js 脚本并调用 mermaid.initialize() 进行初始化。Qoder 的 Web 端知识中心目前尚未集成该渲染能力，而 Qoder IDE 内置了 Mermaid 渲染支持，因此同一份文档在 IDE 中可以正常显示图表。
替代方案
方案一：在 Qoder IDE 中查看（推荐）
直接在 Qoder IDE 内打开对应的 Wiki 文档，即可正常预览 Mermaid 图表，无需额外配置。
方案二：在线渲染工具
将 Mermaid 代码块复制到 Mermaid Live Editor，可实时预览并导出为 SVG / PNG / PDF 格式，还支持生成分享链接。
方案三：本地编辑器查看
VS Code：1.86+ 版本已原生支持 Mermaid，在 Markdown 文件中使用
```mermaid代码块后，按Ctrl+Shift+V即可预览；旧版本需安装 Markdown Preview Mermaid Support 插件。Typora：在偏好设置 → Markdown 中勾选"图表"选项并重启即可。
Obsidian：原生支持 Mermaid，确保设置中 Mermaid 插件已启用。
方案四：命令行批量导出
安装 mermaid-cli 工具：
npm install -g @mermaid-js/mermaid-cli
使用 mmdc 命令批量导出图片，适合 CI/CD 场景：
mmdc -i input.mmd -o output.svg
导出后可将图片直接嵌入 Wiki 文档中，绕过 Web 端渲染限制。
方案五：自建渲染环境
如果你有自建文档站点的需求，可通过 CDN 引入 mermaid.js 脚本，在页面中调用 mermaid.initialize() 或 mermaid.run() 实现渲染。VuePress、Docusaurus 等静态站点生成器也有对应的 Mermaid 插件可直接集成。
排查建议
如果你发现部分图表能渲染、部分不能，则可能是 Mermaid 语法本身存在问题（如拼写错误、图表类型声明不正确等），建议通过 Mermaid Live Editor 逐段校验语法。
后续建议
持续关注 Qoder 版本更新日志，Web 端后续版本可能会补充 Mermaid 渲染支持。你也可以向 Qoder 官方提交功能需求反馈。