Markdown、JSON、CSV：AI 常用的数据格式怎么读

AI给你的资料可能是一段可读说明、一个JSON对象，或一张CSV表。它们都能用文本编辑器打开，但每种格式组织内容的方式不同。先认出结构，你才知道该找哪个字段，也更容易发现少列、错分隔符或格式错误。

这篇用同一场虚构读书会的资料，对照Markdown、JSON和CSV。你只需打开文件、找出几个字段并核对三种写法；不需要编程或AI账号。

先认识三种格式

格式	常见用途	打开后先看哪里
Markdown（`.md`）	写说明、笔记和教程	`#`标题、`-`清单、段落和链接
JSON（`.json`）	传递字段明确、可能有层级的数据	大括号里的键和值、方括号里的多条记录
CSV（`.csv`）	在表格软件或程序间传递行列数据	第一行表头、每行字段、分隔符

Markdown偏向把内容写给人看；JSON用键名标注每个值；CSV把记录平铺成表格。换文件后缀并不会把一种格式转换成另一种。

同一场活动的三种写法

Markdown：先读内容和层级

# 社区读书会

- 主题书：海边的房间
- 日期：2026-11-07
- 时间：14:00
- 地点：河畔图书馆二楼
- 名额：8 人

## 报名名单

#表示标题，-开头的是清单。你在文本编辑器里也能直接读懂内容。常见Markdown还会用表格语法，但各个应用支持的扩展不完全一样；想要更容易移植，标题和清单通常更稳妥。CommonMark基础规范说明了通用语法，也指出不同实现可能支持不同扩展。

完整的活动说明.md还列出三位报名者及其状态。

JSON：沿着键名找值

{
  "event": "社区读书会",
  "book": "海边的房间",
  "date": "2026-11-07",
  "time": "14:00",
  "location": "河畔图书馆二楼",
  "capacity": 8,
  "signups": [
    {"name": "林林", "status": "已确认"},
    {"name": "周然", "status": "候补"},
    {"name": "陈默", "status": "已确认"}
  ]
}

JSON里"date"是键名，后面的字符串是它的值；8是数字，不需要加引号。signups后面的方括号装着多条报名记录，每条记录用大括号包起来。

JSON字符串必须使用双引号，最后一个字段后不能留逗号，也不支持注释。文件夹里的错误示例-尾逗号.json就多了一个逗号。若已按Python入门准备环境，可以运行：

python -m json.tool 活动信息.json

合法文件会格式化打印；无效文件会给出所在位置附近的解析错误。这个命令只读取并显示，不会改动源文件。JSON语法以IETF RFC 8259为准。

CSV：先对表头，再对每一行

event,book,date,time,location,capacity,name,status
社区读书会,海边的房间,2026-11-07,14:00,河畔图书馆二楼,8,林林,已确认
社区读书会,海边的房间,2026-11-07,14:00,河畔图书馆二楼,8,周然,候补

第一行是表头，后面每行是一位报名者。这个例子把同一场活动的信息重复在每行里，让每条报名记录都能单独筛选。CSV通常不标注数据类型，表格里的8读进程序时也可能还是文字，需要程序按用途转换。

先核对每行字段是否和表头对应。这个练习里的字段没有额外逗号，可以直接观察分隔符；真实CSV可能用双引号包住含逗号的字段，不能只靠数逗号判断列数。错误示例-缺状态列.csv把status写成了state；如果后续程序要取status，就会找不到它。示例-分号分隔.csv改用分号分隔。分号格式不一定损坏，但读取它的程序必须知道实际分隔符。不同表格软件导出的CSV也可能有细微差异，遇到问题时先用纯文本编辑器看表头和分隔符。Python的CSV文档说明，CSV模块可以按不同分隔规则读取表格；常规读取不会自动把字段转成数字。

做一次交叉核对

打开练习包里的活动说明.md、活动信息.json和报名记录.csv，逐项查找日期、地点、名额、报名人和状态。三种格式都应对应同一组事实：日期是2026-11-07，地点是“河畔图书馆二楼”，名额8人；林林和陈默已确认，周然候补。

再看两个错误样例：JSON为什么解析失败？CSV表头是否包含status？分号文件若交给默认按逗号读取的程序，会被拆成几列？练习包的练习与核对.md提供答案；先自己找一遍，再对照。

常见卡点

现象	可以先查
JSON校验失败	双引号、冒号、逗号和括号是否配对；末尾是否多了逗号
CSV某些字段取不到	首行列名是否拼对，数据行字段数是否和表头相符
CSV看起来挤在一列	文件是否用分号或制表符分隔；不要只凭`.csv`后缀猜
中文乱码	文件编码和打开它的应用是否匹配；先用练习包里的UTF-8样例比较
Markdown表格没有排版	当前应用可能不支持表格扩展；查看原始竖线分隔内容，或改用清单

完成后

你应能从Markdown里找到说明，从JSON里按键名找值，从CSV里对照表头查看记录，并能指出尾逗号、缺列和分隔符不匹配这三种问题。练习只用虚构数据；检查时打开压缩包中的副本，不要覆盖原文件。

文件、扩展名和压缩包还不熟悉，可以先看D1文件与路径入门。想运行可选的JSON检查命令，再看Python入门；本篇的主要练习不需要编程，也不依赖AI模型。练习材料包可从这里下载。

本文用到的语法来源： CommonMark规范、RFC 8259、Python JSON文档和Python CSV文档。封面背景由AI生成，标题另行排版。