Azure DevOps Wiki中Mermaid语法解析失败，求解决方案

我之前在Azure DevOps Wiki里画Mermaid流程图时，也碰到过一模一样的版本兼容问题——旧版Mermaid不支持新的数据库节点语法，给你几个亲测有用的解决办法，以及获取旧版Mermaid文档的方式：

一、适配旧版Mermaid的数据库节点写法 #

Azure DevOps Wiki内置的Mermaid版本通常偏老，不支持[(Database)]这种较新的数据库节点语法，你可以用以下两种替代方式：

1. 矩形节点+文本标注 #

用普通矩形节点，在文本里明确标注是数据库，简单直接：

graph LR
    id1[Database]

2. 自定义样式模拟数据库节点 #

如果想要更贴近数据库的视觉效果，可以通过classDef定义样式，给节点加上圆角和主题色：

graph LR
    id1[Database]
    classDef db fill:#0078d4,stroke:#333,stroke-width:2px,border-radius:10px;
    class id1 db;

二、获取Mermaid旧版官方文档 #

要查看Azure DevOps当前兼容的旧版Mermaid语法，你可以这样做：

• 打开Mermaid的GitHub仓库，切换到对应旧版本的标签（比如v8.13.4，这是不少Azure DevOps实例使用的版本）
• 查看该标签下的README.md或者docs目录里的文档，里面会列出对应版本支持的所有语法

三、其他替代方案 #

如果以上写法都达不到你的需求，还可以试试：

• 本地用最新版Mermaid生成流程图图片，然后上传到Azure DevOps Wiki里插入图片
• 用Azure DevOps支持的HTML标签嵌入外部生成的Mermaid图（不过部分实例可能限制HTML使用，需要先测试）

内容的提问来源于stack exchange，提问作者Peter Smit