飞书 Markdown 兼容指南

生成将导入飞书的 Markdown 前，按本指南检查。执行导入用 feishu-cli-import，编辑已有文档用 feishu-cli-write。

快速检查

内容	必检项
Mermaid	禁花括号标签、禁 `par...and...end`、sequenceDiagram participant ≤ 8
PlantUML	无行首缩进、无 `skinparam`/`!define`、类图不写 `+ - # ~` 可见性
表格	行 > 9 可导入同一 block；列 > 9 会拆列组；超大表建议 Sheet
图片	`doc import` 默认上传；`doc add/content-update` 需传 `--upload-images`
公式	行内 $...$ ；块级公式会以 Text+Equation 元素导入
Callout	仅 NOTE/WARNING/TIP/CAUTION/IMPORTANT/SUCCESS

推荐 Mermaid；飞书服务端支持 8 类常见图。