CSV转Markdown时csv模块报错需用dialect='unix'和quoting=csv.QUOTE_MINIMAL；Sublime需配置Python路径并启用-u参数；Markdown表格须动态计算列宽、转义|符号、处理空值与对齐。
CSV转Markdown时，csv模块解析失败怎么办
直接用Python的csv模块读取带中文、逗号、换行符的CSV文件，大概率会报csv.Error: new-line character seen in unquoted field。这不是编码问题，而是默认dialect='excel'不支持字段内换行——哪怕你加了encoding='utf-8-sig'也没用。
真正管用的做法是：显式指定dialect='unix'，并用quoting=csv.QUOTE_MINIMAL让解析器正确识别引号包裹的字段：
import csv
with open('data.csv', encoding='utf-8-sig') as f:
reader = csv.reader(f, dialect='unix', quoting=csv.QUOTE_MINIMAL)
rows = list(reader)
- 别用
csv.DictReader——它依赖首行当键，但很多CSV首行含空格或特殊字符，容易键名错位 - 如果CSV第一行是标题，
rows[0]就是表头，后续rows[1:]是数据，别搞反 - Sublime Text里跑脚本前，先用
File → Reopen with Encoding → UTF-8确认文件实际编码，否则utf-8-sig可能失效
在Sublime Text里一键运行转换脚本的关键配置
Sublime Text本身不内置Python环境，Build System必须指向你本地安装的Python解释器路径，否则会提示python: command not found。
新建Tools → Build System → New Build System，填入：
{
"shell_cmd": "python -u "$file"",
"file_regex": "^[ ]*File "(...*?)", line ([0-9]*)",
"selector": "source.python"
}
-
"shell_cmd"里的-u参数强制Python输出不缓冲，避免Sublime卡在“正在运行”状态不动 - Windows用户要把
python换成绝对路径，比如"C:\Python39\python.exe"，否则系统PATH没配好就找不到 - 保存为
PythonMD.sublime-build，然后按Ctrl+Shift+B选它——不是选“Python”，那个是默认构建系统，不认你的脚本路径
生成Markdown表格时，列宽对齐和空值处理的硬伤
CSV转Markdown表格，最常踩的坑是列宽不一致导致渲染错乱，以及None或空字符串变成||这种难看的空格占位。
别手写|---|---|分隔线，用max()动态算每列最大宽度：
def md_table(rows):
if not rows: return ""
cols = len(rows[0])
widths = [max(len(str(row[i])) for row in rows) for i in range(cols)]
lines = []
lines.append("|" + "|".join(str(row[i]).ljust(widths[i]) for i in range(cols)) + "|")
lines.append("|" + "|".join("-" * w for w in widths) + "|")
for row in rows[1:]:
lines.append("|" + "|".join((str(x) if x is not None else "").ljust(widths[i]) for i, x in enumerate(row)) + "|")
return "
".join(lines)
- 字段含
|符号？必须提前用str.replace("|", "\|")转义，否则Markdown解析器会当成分隔符切开 - 数字列想右对齐？把
.ljust()换成.rjust()，但只对纯数字字段生效，混文本就崩 - 空单元格留白还是写
Sublime Text插件替代方案：Table Editor不够用，得手动补逻辑
装了Table Editor插件，按Ctrl+Alt+T能转成表格，但它只处理当前选中区域，且无法跳过CSV首行作为标题——它一律当普通行处理。
真想用插件省事，得配合正则预处理：
- 全选CSV内容 →
Ctrl+H打开替换，勾选Regular Expression - 查找：
^([^, ]*),(.*)$，替换为：|$1|$2|（把每行转成管道分隔） - 再对第一行执行：
^.*$→$0 |---|---|...|（手动补分隔线，列数要数准） - 最后全局替换
,为|，但注意别动已有的|——所以得用(?这种负向断言
说到底，插件适合简单无格式CSV；一旦字段含引号、换行、逗号嵌套，还是脚本靠谱。手动正则容易漏转义、列数算错，一粘贴就渲染失败——这种细节，跑一遍脚本比调十分钟正则更稳。
