Smart Mermaid，是一个基于 AI 的 Web 应用，可将文本内容智能转换为 Mermaid 格式的代码，并将其渲染成可视化图表。
🎯 项目概述
- 功能：将自然语言文本或上传的
.txt、.md、.docx文件内容，通过 AI 自动转换成 Mermaid 代码，并实时渲染为可视化图表（如流程图、序列图、甘特图、状态图等） - 目的：帮助用户摆脱手写 Mermaid 代码的繁琐，一键从文字描述生成标准图表代码，提升制作效率
🚀 核心功能亮点
- 智能文本解析
- 支持最大约 20,000 字符输入、文件上传。
- AI 自动识别或由用户手动选择图表类型，生成 Mermaid 代码并支持流式预览
- 双重渲染模式
- Mermaid 渲染器：标准图表，支持缩放、专业视图控制。
- Excalidraw 渲染器：更像手绘图形，支持拖拽、样式调整
- 实时代码编辑
- 使用 CodeMirror 集成编辑器，支持 Mermaid 语法高亮、验证和实时反馈
- AI辅助功能
- 自动修复：AI 检测 Mermaid 语法错误并提供修复建议。
- 方向切换：支持横向（LR）和纵向（TD）布局一键切换
- 导出和分享
- 支持将图表导出为 SVG、PNG，或复制 Mermaid 源代码
⚙️ 使用与配置
- 免费体验：可直接访问在线 Demo（smart‑mermaid.aizhi.site），每天有 5 次免费生成额度，已有内置 API Key 支持
- 密码模式：输入作者提供的访问密码后可不限次数使用。
- 自定义 AI 服务：支持使用自己配置的 OpenAI 或其他服务 API，实现无限调用
🛠 技术栈
- 使用 Next.js（App Router）、Tailwind CSS、shadcn/ui + Radix UI 构建前端接口。
- 渲染依赖 mermaid 和 @excalidraw/excalidraw，转换依赖 @excalidraw/mermaid-to-excalidraw。
- 集成 CodeMirror 编辑器与 mammoth 文件解析。
- AI 支持框架可兼容 OpenAI API。
- Docker 与 Docker Compose 一键部署支持
🛠 使用流程简述
- 输入文本或上传文件。
- 选择图表类型或自动识别。
- 点击“生成”，AI 实时输出 Mermaid 代码与图形预览。
- 如需修改或导出，在编辑器进行调整并导出为 SVG/PNG 或复制代码。
📝 总结
Smart Mermaid 简化了从文字到图表的流程，利用 AI 自动生成标准 Mermaid 代码，支持实时编辑、双渲染、修复优化与导出，非常适合文档撰写、项目管理和教学可视化场景。如果你常需要用 Mermaid 画图，这个工具能大大提升效率。
