用途：把 Markdown 文件里的 Mermaid 代码块转换成带样式的 PNG/SVG 图片，适合文章、幻灯片、博客或微信公众号配图，也适用于用户只说“让这张 Mermaid 图更好看”而未指定格式的情况。
主要能力：内置多种主题，可按场景选择——fresh-business 适合报告、文档、业务流程；dark-tech 适合架构、工程、API/系统图；hand-drawn 适合构思、教学、工作坊笔记；gradient-modern 适合产品、营销、演讲风格。支持 PNG 或 SVG 输出，可指定宽度，并可生成替换了图片链接的新 Markdown 文件。转换器会自动识别常见 Mermaid 图表类型。
使用方式：先确认 Markdown 含 Mermaid 代码块，再运行脚本，例如：python3 mermaid-to-png/scripts/convert.py <input-file> --style fresh-business --width 900 --replace。常用选项包括 --style、--format png|svg、--width（默认 1200）、--replace（生成 <input>_converted.md）、--output-dir、--chart-type auto|flowchart|sequence|gantt|class|state、--allow-npx、--disable-browser-sandbox。微信公众号场景建议 --width 900，除非用户另有要求。
限制与前提：需先安装 npm install -g @mermaid-js/mermaid-cli。优先使用本地 mmdc；npx 回退默认关闭，需显式加 --allow-npx；禁用浏览器沙箱也需显式加 --disable-browser-sandbox，且仅限可信受限环境。使用 --replace 时，转换后的 Markdown 引用同一输出目录中的图片文件名。渲染失败时先检查 Mermaid 语法，再确认 mmdc/Puppeteer 能在本地运行。