用途：将 Markdown 或其他文本文件中的 ```mermaid 代码块转换为 PNG 图片，并用图片引用替换原代码块，适用于 GitHub Pages、Jekyll、Dev.to 等不原生渲染 Mermaid 的平台。
主要能力：扫描目标文件中的 mermaid 代码块并统计数量；确定图片输出目录；逐块调用 mermaid.ink API 渲染为 PNG；按内容使用可描述的英文文件名（如 architecture-overview.png），避免 mermaid-1.png 之类泛化命名；用 Markdown 图片引用替换代码块，路径风格可选相对路径或绝对 URL；处理完成后汇报转换数量、保存位置和修改文件。
必要用法：渲染需使用 mermaid.ink 的图片接口，代码先做 base64 urlsafe 编码，请求必须带 User-Agent 头，否则返回 403；示例逻辑为编码后拼接 https://mermaid.ink/img/<encoded>?bgColor=white，再用 urllib 下载写入文件。可指定单个文件、目录下多个文件或某个特定代码块。输出目录优先查找 images/、assets/images/ 等常见目录，不确定时询问用户。
适用场景：文档或 README 中的架构图、数据流图、时序图需要在静态静态站点或发布流程中以图片形式呈现；同一文件多个代码块按顺序处理并各自命名。
限制：mermaid.ink 对非常复杂的图可能超时，失败时只能报告错误并建议简化或用其他渲染器；已生成对应图片的代码块需跳过或询问；非 Markdown 文本文件同样可处理。资料未提供收费、性能保证或替代渲染器细节。