如何本地生成超大Mermaid图？遇"Maximum text size diagram exceeded"错误

调整Mermaid-CLI参数绕过限制 #

• 无需寻找配置文件，直接通过命令行传递自定义配置参数，覆盖默认的文本尺寸限制：

  mmdc -i 你的图表文件.mmd -o 输出文件.svg --config '{ "maxTextSize": 1000000, "securityLevel": "loose" }'
  

  把maxTextSize设为足够大的值（比如1000000），同时放宽安全级别避免额外限制。如果图表尺寸过大，还可以加上--width和--height参数指定更大的画布尺寸。

拆分大图表 #

• 将2000行的单图表按逻辑模块拆分成多个子图表，每个子图表控制在500行以内，分别生成SVG后再手动拼接，从根源上避开单文件尺寸限制。

用Node.js脚本调用Mermaid核心API #

• 编写简单的Node.js脚本，直接调用Mermaid核心库并自定义配置，完全摆脱CLI的默认限制：

  const mermaid = require('mermaid');
  const fs = require('fs');
  
  // 初始化时设置自定义配置
  mermaid.initialize({
    maxTextSize: 1000000,
    securityLevel: 'loose'
  });
  
  // 读取Mermaid文件内容并生成SVG
  const mmdContent = fs.readFileSync('你的图表文件.mmd', 'utf8');
  mermaid.render('custom-diagram', mmdContent)
    .then(result => fs.writeFileSync('输出文件.svg', result.svg))
    .catch(err => console.error('生成失败:', err));
  

修复Docker版mermaid-server的配置问题 #

• 运行容器时通过环境变量传递自定义配置，覆盖默认限制：

  docker run -p 8080:8080 -e MERMAID_CONFIG='{"maxTextSize": 1000000, "securityLevel": "loose"}' tomwright/mermaid-server
  

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