如何快速上手 Mermaid Live Editor：零基础也能轻松制作专业流程图的完整指南 🚀

Mermaid Live Editor 是一款免费开源的在线图表编辑工具，支持实时编辑和预览流程图、序列图、甘特图等多种可视化图表。作为轻量级 Visio 替代方案，它能帮助你用简单代码快速生成高质量 diagrams，无需复杂设计软件！

📌 为什么选择 Mermaid Live Editor？

✅ 核心优势一览

• 实时双向编辑：代码修改即时同步到预览窗口，所见即所得
• 多图表支持：流程图、序列图、类图、状态图等 10+ 图表类型全覆盖
• 纯文本编辑：用类 Markdown 语法编写，易于版本控制和协作
• 一键导出分享：支持 SVG/PNG 下载、链接分享和嵌入到文档
• 完全免费开源：基于 Svelte 框架开发，代码托管在 GitCode

📥 3 分钟极速安装指南

本地开发环境搭建（推荐）

1. 克隆项目仓库

   git clone https://gitcode.com/gh_mirrors/me/mermaid-live-editor.git
   cd mermaid-live-editor
   

2. 安装依赖（需 Node.js 环境）

   pnpm install
   

3. 启动开发服务器

   pnpm dev -- --open
   

   ✨ 浏览器会自动打开 http://localhost:3000，现在你可以开始创作了！

Docker 一键部署方案 🐳

如果熟悉 Docker，可通过容器快速运行：

docker compose up --build

访问 http://localhost:3000 即可使用编辑器。

🎯 新手必备操作指南

界面功能区域解析

编辑器主要分为三大区域：

• 左侧代码区：使用 Mermaid 语法编写图表定义
• 右侧预览区：实时显示渲染效果，支持缩放和平移
• 顶部工具栏：提供新建、保存、导出和主题切换等功能

快速创建第一个流程图

1. 在左侧编辑框输入以下代码：

   graph TD
     A[开始] --> B{选择操作};
     B -->|编辑| C[代码区];
     B -->|预览| D[结果区];
     C --> E[生成图表];
     D --> E;
     E --> F[导出分享];
   

2. 右侧会立即显示流程图效果，试试修改文字内容，观察实时变化！

常用图表类型及示例

• 序列图：展示对象间交互
• 甘特图：项目时间线规划
• 饼图：数据占比可视化
• 类图：面向对象设计

🛠️ 常见问题解决方案

🔍 图表预览空白怎么办？

1. 检查语法错误：Mermaid 对缩进和符号敏感，确保箭头 --> 和分号 ; 使用正确
2. 清除浏览器缓存：按 Ctrl+Shift+R 强制刷新页面
3. 验证依赖完整性：删除 node_modules 后重新执行 pnpm install

📤 无法导出图片？

修改 Docker 构建参数启用渲染服务：

docker build \
  --build-arg MERMAID_RENDERER_URL=https://mermaid.ink \
  -t mermaid-live-editor .

💡 进阶技巧与资源

主题自定义

通过顶部工具栏的「Theme」按钮切换深色/浅色模式，或在代码中添加配置：

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#ff4400' }}}%%
graph TD
  A[自定义主题] --> B[惊艳效果];

实用快捷键

• Ctrl+S：保存当前图表
• Ctrl+I：自动格式化代码
• Ctrl+K：打开快捷键帮助

学习资源推荐

• 官方示例库：src/lib/util/mermaid.ts
• 语法参考：在编辑器中点击「?」图标查看完整文档
• 社区模板：Discord 频道每周分享优质图表案例

📈 开始你的图表创作之旅

无论你是产品经理画流程图、开发人员设计系统架构，还是学生制作报告图表，Mermaid Live Editor 都能让复杂的可视化工作变得简单高效。现在就动手试试，用代码绘制你的第一个专业图表吧！

💡 提示：项目完全开源，欢迎通过提交 PR 参与功能改进，或在 Issues 中反馈使用问题。