利用Sublime Text快速将CSV转换成Markdown-sublime-PHP中文网

csv转markdown时csv模块报错需用dialect='unix'和quoting=csv.quote_minimal；sublime需配置python路径并启用-u参数；markdown表格须动态计算列宽、转义|符号、处理空值与对齐。

利用sublime text快速将csv转换成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或空字符串变成||这种难看的空格占位。

QuickBooks Mileage CSV

使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。

下载

别手写|---|---|分隔线，用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)