本技能是飞书 Markdown 兼容指南，用于在生成将导入飞书的 Markdown 前做兼容性检查，也用于排查 doc import 渲染失败或需要飞书兼容图表语法的场景。导入执行可配合 feishu-cli-import，编辑已有文档用 feishu-cli-write。
主要检查项：Mermaid 禁用花括号标签、禁 par...and...end、sequenceDiagram 参与者不超过 8；PlantUML 不使用行首缩进，避免 skinparam 与宏；表格行数超过 9 可用 insert_table_row 追加同一 block，列数超过 9 会拆分列组；图片在 doc import 下默认上传，doc add/content-update 需显式传 --upload-images；行内公式用 $...$；Callout 仅支持 NOTE、WARNING、TIP、CAUTION、IMPORTANT、SUCCESS。
Mermaid 为推荐方案，飞书服务端支持流程图、时序图、类图、状态图、ER 图、甘特图、饼图、思维导图等常见类型，状态图须用 stateDiagram-v2。PlantUML 仅在 Mermaid 不覆盖的图类型时使用，需保留 @startuml/@enduml，类图成员写 field : type、method()。
数据表、长表和需排序筛选内容优先生成 Sheet，可用 feishu-cli sheet import-md。媒体精确插入用 feishu-cli doc media-insert。导入前应确认文件为 UTF-8 且无替换字符，图片路径可从 Markdown 所在目录解析。扩展标签如 mention-user、mention-doc、grid 等支持 roundtrip，手写时仅用确实需要的标签。