使用fitten code插件可一键将mysql表结构转为格式规范的markdown表格:自动处理表头加粗、对齐、空值替换(“—”)、换行转义,并支持带时间戳写入.md文件供预览。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要把MySQL数据库里某个表的字段结构快速转成一份可读性强、能直接放进文档或Wiki里的Markdown表格,而不是手动一个字段一个字段敲格式、对齐、加注释。
连接数据库并读取表结构
打开VSCode,确保已安装并启用Fitten Code插件(v1.9.3及以上)。【必须使用Python 3.8+环境,且已安装pymysql】
新建一个.py文件,输入以下代码片段(不用全写,只需触发Fitten Code):
```python
import pymysql
conn = pymysql.connect(
host="127.0.0.1",
user="root",
password="your_pass",
database="your_db"
)
cursor = conn.cursor()
cursor.execute("SELECT COLUMN_NAME, DATA_TYPE, IS_NULLABLE, COLUMN_DEFAULT, COLUMN_COMMENT FROM information_schema.COLUMNS WHERE TABLE_SCHEMA=%s AND TABLE_NAME=%s", ("your_db", "your_table"))
rows = cursor.fetchall()
conn.close()
```
将光标放在rows = cursor.fetchall()这一行末尾,按下Ctrl+Alt+G(Windows/Linux)或Control+Option+G(macOS),唤出“生成代码”面板。
在提示框中输入:“把rows转换成Markdown表格,列名依次为:字段名|类型|是否为空|默认值|备注,中文列名加粗,类型列右对齐,空值显示‘—’,备注列保留原始换行(用
代替)”
生成带格式的Markdown表格代码
AI会立即返回一段结构清晰的Markdown字符串拼接代码。它会自动处理:表头加粗、分隔线对齐符号(如|:---|---:|:---:|:---|:---|)、空值替换、换行符转义。
复制生成的代码,粘贴到当前.py文件末尾,运行脚本。
输出结果是纯文本格式的Markdown表格,例如:
# users 表数据字典
| **字段名** | **类型** | **是否为空** | **默认值** | **备注** |<br><code>|:---|---:|:---:|:---|:---|<br><code>| id | bigint | NO | — | 主键自增<br>用户ID |<br><code>| username | varchar(50) | NO | — | 用户登录名 |<br><code>| created_at | datetime | YES | CURRENT_TIMESTAMP | 创建时间 |</code></code></code></code>
注意:如果字段备注含换行,Fitten Code默认用<br>替代,但GitHub Flavored Markdown不渲染该标签——【需手动将
替换成两个空格加回车】,否则会显示为文字“
”。
一键写入.md文件并预览
在生成的Markdown字符串变量名后(比如叫md_table),光标停在其后,再次按Ctrl+Alt+G。
输入指令:“把md_table内容写入当前目录下的data_dict_users.md,编码utf-8,开头追加# users 表数据字典,不要覆盖已有同名文件,而是重命名为data_dict_users_20260618.md”
Fitten Code会生成带时间戳的文件写入逻辑,并自动调用datetime.now().strftime("%Y%m%d")。
运行脚本,文件生成完毕。在VSCode中右键点击新生成的.md文件 → “Open Preview”,即可看到渲染后的表格效果。










