navicat 16 不支持一键导出整库/单表为 markdown，但可通过「对象信息→列」视图复制带注释的字段结构为 markdown 表格，需确保注释已真实写入数据库元数据（如 mysql 用 innodb、pg 手动执行 comment on column），并手动添加表名与表注释。

navicat 16 本身不支持“一键导出整库/单表为 markdown 文档”，但可以组合使用「对象信息」+「复制为 markdown 表格」+ 少量手动整理，实现快速产出带字段注释的结构文档——前提是注释已真实写入数据库元数据。

确认字段注释是否已生效，否则复制出来全是空

Navicat 的「复制为 Markdown 表格」只读取数据库实际存储的 COLUMN_COMMENT，不是界面上你随便填过的本地缓存。常见失效原因：

• MySQL 表用了 MyISAM 引擎：不支持字段级 COMMENT，必须是 InnoDB
• PostgreSQL 没执行过 COMMENT ON COLUMN：Navicat 图形界面在 PG 连接下不暴露字段注释输入框，必须手写 SQL 补充
• 字段注释超长被截断：MySQL 限制 1024 字符，超出部分不会入库，SHOW FULL COLUMNS 也查不到
• 连接字符集未设为 utf8mb4：中文注释显示为空或乱码，检查 Navicat 连接「高级」页签中 characterSet=utf8mb4 是否启用

用「对象信息 → 列」视图复制，不是「设计表」

很多人在「设计表」里填了 Comment，却复制不出内容——因为那个只是本地编辑态，不触发 DDL。真正能被复制的注释，必须来自「对象信息」窗口：

• 右键目标表 → 选择「对象信息」
• 顶部切换到「列」页签
• 确保「Comment」列可见（若不可见，右键列头 → 勾选「Comment」）
• 全选所有行（Ctrl+A），右键 → 「复制为 Markdown 表格」

复制结果类似：

|列名|类型|允许为空|默认值|注释|
|---|---|---|---|---|
|id|BIGINT|NO||主键ID|
|status|TINYINT|YES|NULL|0=待审核,1=已通过,2=已拒绝|

补上表名、表注释和标题，5秒搞定基础文档

「复制为 Markdown 表格」只给字段结构，没有表名和表注释。你需要手动加两行：

Telegram Markdown Adapter

将 Markdown 格式的回复转换为适合 Telegram 的富文本，避免渲染错误。适用于用户偏好 Markdown 但目标平台为 Telegram 的场景。

下载

• 先在「对象信息」→「常规」页签里复制 Table comment 的内容（如「用户登录日志表」）
• 在 Markdown 表上方加标题：## user_login_log — 用户登录日志表
• 如果需要多张表，每张表之间空一行，再加下一个 ## 标题即可

注意：不要依赖「数据库快照」导出 HTML 再转 Markdown——那适合整库结构归档，单表场景太重，且容易因 title 属性未提取导致类型丢失（如 DATETIME 变成 VARCHAR）。

导出前最后检查三件事

哪怕步骤都对，也可能因三个细节导致文档无效：

• Comment 列是否真的有内容？别只看「设计表」里的灰色输入框，要切到「对象信息 → 列」里亲眼确认
• 复制时是否全选了全部列（含 Comment 列）？漏掉这一列，整张表就只剩空注释
• 粘贴到 Markdown 编辑器后，是否手动删掉了第一行多余的空格或制表符？有些编辑器会把首行缩进识别为代码块

真正卡住人的从来不是操作步骤，而是以为注释“已经填了”，其实它根本没进数据库元数据。