Badger4us1. 为什么选择Typora绘制ER图？
作为一名长期与数据库打交道的开发者，我最初接触ER图绘制工具时尝试过Visio、Lucidchart甚至PowerPoint这类传统方案。直到三年前偶然发现Typora配合Mermaid语法能够实现轻量级ER图绘制，我的工作流才真正发生了质的变化。
Typora之所以成为技术文档工作者的心头好，核心在于它完美平衡了即时渲染与纯文本编辑两种模式。与专业绘图工具相比，用Markdown语法描述ER关系具有几个不可替代的优势：
- 版本控制友好：.md文件比二进制格式的绘图文件更适合Git管理
- 可移植性强：无需安装特定软件，任何Markdown阅读器都能渲染
- 修改成本低：调整实体关系时只需修改文本，无需拖拽图形元素
- 文档一体化：ER图可以直接嵌入技术文档中，保持上下文连贯
实际案例：去年参与某银行系统重构时，我们需要维护超过200张表的ER关系文档。使用Typora后，数据库Schema变更的同步效率提升了60%以上。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与基础配置
2.1 Typora的安装与激活
虽然Typora从1.0版本开始转为付费软件（$14.99终身授权），但开发者仍然提供了完整的试用体验：
- 官网下载对应系统版本（支持Windows/macOS/Linux）
- 安装后首次打开会提示激活，点击"Enter Trial"即可获得15天完整功能试用
- 试用期结束后仍可继续使用，仅会周期性弹出激活提醒（不影响功能）
对于长期使用者，建议通过官网购买正版授权。教育用户可申请50%折扣，团队购买另有优惠。
2.2 Mermaid语法支持配置
Typora默认集成了Mermaid渲染引擎，但需要手动开启：
- 打开偏好设置（Preferences）
- 在"Markdown"选项卡中找到"Mermaid"模块
- 勾选"Enable Mermaid"和"Enable Mermaid Code Block Fence"
验证配置是否成功：新建文档输入```mermaid后回车，如果出现流程图编辑界面说明配置正确。
3. ER图核心语法详解
3.1 基础实体定义
Mermaid的ER图语法采用类PlantUML的声明式风格。以下是一个包含两个实体的最小示例：
mermaid复制erDiagram
CUSTOMER ||--o{ ORDER : places
CUSTOMER {
string name
string email
int age
}
ORDER {
int orderNumber
date orderDate
}
关键语法解析：
||--o{表示一对多关系（1:N）- 实体用大写字母命名（约定俗成）
- 属性定义在花括号内，支持基本数据类型声明
3.2 关系类型全解
Mermaid支持六种标准关系表示法：
| 语法 | 含义 | 示例场景 |
|---|---|---|
| ` | -- | |
| ` | --o{` | |
| `}o-- | ` | |
}o--o{ |
多对多 | 学生-课程 |
| ` | -- | |
| `} | -- | {` |
3.3 高级特性应用
3.3.1 属性约束标注
通过在属性后添加约束标记实现专业级ER图：
mermaid复制erDiagram
STUDENT {
string student_id PK
string name
date birthdate NN
string email UQ
}
COURSE {
int course_code PK
string title NN
}
STUDENT }o--o{ COURSE : "enrolls"
特殊标记说明：
PK：主键（Primary Key）NN：非空（Not Null）UQ：唯一（Unique）FK：外键（需配合关系定义）
3.3.2 继承关系表示
使用<|--符号表示泛化关系：
mermaid复制erDiagram
USER {
int id PK
string login
}
EMPLOYEE <|-- USER
CUSTOMER <|-- USER
EMPLOYEE {
string department
}
4. 实战：MySQL数据库逆向工程
4.1 从SQL生成ER图
对于已有数据库，可以通过mysqldump导出结构后转换为Mermaid语法：
- 导出数据库结构：
bash复制mysqldump -u root -p --no-data dbname > schema.sql
- 使用Python脚本转换（简化版）：
python复制import re
tables = {}
current_table = None
with open('schema.sql') as f:
for line in f:
if match := re.match(r'CREATE TABLE `(\w+)`', line):
current_table = match.group(1)
tables[current_table] = {'columns': [], 'relations': []}
elif current_table and (match := re.match(r' `(\w+)`.*', line)):
col = match.group(1)
tables[current_table]['columns'].append(col)
print("erDiagram")
for table, data in tables.items():
print(f" {table} {{")
for col in data['columns']:
print(f" string {col}")
print(" }")
4.2 复杂案例：电商系统ER图
完整电商核心模型示例：
mermaid复制erDiagram
USER ||--o{ ORDER : places
USER {
int user_id PK
string username UQ
string password NN
string email UQ
}
ORDER ||--|{ ORDER_ITEM : contains
ORDER {
int order_id PK
date created_at NN
decimal total_amount
}
PRODUCT ||--o{ ORDER_ITEM : "ordered as"
PRODUCT {
int product_id PK
string name NN
decimal price NN
int stock
}
CATEGORY }o--o{ PRODUCT : "classified in"
CATEGORY {
int category_id PK
string name NN
}
ORDER_ITEM {
int item_id PK
int quantity NN
decimal unit_price NN
}
5. 排版优化与导出技巧
5.1 主题样式调整
Typora支持通过CSS自定义ER图样式：
- 打开主题文件夹（Help → Open Theme Folder）
- 编辑
base.user.css添加：
css复制.mermaid .er-entityBox {
fill: #f8f9fa;
stroke: #495057;
}
.mermaid .er-attributeBoxEven {
fill: #e9ecef;
}
.mermaid .er-relationshipLabel {
font-size: 14px;
}
5.2 导出为其他格式
Typora支持多种导出格式，但需注意：
- PDF导出：需保持联网状态（字体渲染需要）
- HTML导出：会保留交互式Mermaid图
- Word导出：建议先转为PNG图片（防止格式错乱）
最佳实践是先导出HTML，再用浏览器打印为PDF，可获得最佳排版效果。
6. 常见问题解决方案
6.1 中文显示异常
当实体或属性包含中文时，可能出现乱码或布局错乱。解决方法：
- 在Typora首选项 → 通用 → 默认编码选择UTF-8
- 在文档开头添加HTML注释：
html复制<!--
<style>
:root { font-family: "PingFang SC", "Microsoft YaHei"; }
</style>
-->
6.2 大型图表优化
当ER图超过20个实体时，可能会遇到渲染性能问题。建议：
- 按业务模块拆分多个mermaid代码块
- 使用
%%{init}%%指令调整布局参数：
mermaid复制erDiagram
%%{init: {"er": {"useMaxWidth": false}} }%%
// 实体定义...
6.3 与PlantUML的对比
虽然PlantUML也能绘制ER图，但Mermaid的优势在于：
- 语法更简洁（减少30%代码量）
- 原生集成在Typora中
- 实时渲染速度更快
- 更适合嵌入Markdown文档
不过对于需要UML全系列图表的场景，PlantUML仍是更专业的选择。