You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Asciidoctor中渲染Mermaid C4类型的流程图?

在Asciidoctor中渲染Mermaid C4流程图的解决方案

是的,你需要额外配置C4相关支持才能在Asciidoctor中渲染Mermaid C4流程图,默认Mermaid环境(包括Asciidoctor集成的版本)并不内置C4语法定义。以下是具体解决步骤:

1. 确认Mermaid版本要求

Mermaid从v10版本开始正式内置C4模型语法支持,如果你的Asciidoctor使用的Mermaid版本低于v10,必须先升级Mermaid环境。

2. 配置Asciidoctor的Mermaid环境

  • 若使用Asciidoctor.js(浏览器或Node.js场景):确保加载的是包含C4扩展的Mermaid包,部分旧版本可能需要单独引入mermaid-c4扩展。
  • 若使用Asciidoctor PDF等离线渲染工具:需要在工具配置中指定使用v10及以上版本的Mermaid,确保渲染引擎能识别C4语法。

3. 修正C4代码示例

你的代码可补充初始化配置以适配部分严格安全策略的环境,完整可运行示例如下:

[mermaid]
....
%%{init: {'securityLevel': 'loose'}}%%
C4Context
    Person(Customer, "Member")
    Person(Ops, "Ops")
    Rel(Customer, Ops, "咨询", "电话/IM")
....

4. 版本排查方法

若不确定当前Mermaid版本,可渲染以下代码确认:

[mermaid]
....
version
....

内容的提问来源于stack exchange,提问作者user5580578

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.30 07:27:18