ViewCSV打开或粘贴 CSV 文件，选项旁边就会出现一张竖线表格，可以直接用在 README、Issue 或 Wiki 页面中。值里的 | 会写成 \|，因此绝不会把单元格拆开；单元格内的换行会变成 <br>，数字列右对齐。文件在你的浏览器中转换，不会上传。
如何把 CSV 转换为 Markdown
- 点击 打开文件，把
.csv、.tsv或.txt文件拖到工具上，或选择 粘贴。分隔符会自动识别；如果识别错误，可在 导入设置 中设置分隔符、编码或 第一行是列名（表头）。 - 选择 列对齐 方式，以及 单元格内换行 的写法。Markdown 标签页中显示的就是下载文件的实际内容。
- 点击 复制，把表格直接粘贴到 GitHub、GitLab 或编辑器中；或点击 下载 Markdown 保存为
.md文件。
如果文件没有表头行，请关闭 第一行是列名（表头）：Markdown 表格必须有表头，所以各列会被命名为 Column 1、Column 2 等。如果想把同样的数据做成网页表格，请使用 CSV 转 HTML。
各选项的作用
| 数字右对齐，文本默认 | 默认选项。只有当某列所有非空值都是普通数字时，该列才会右对齐（---:）；只要有 00731 或 12 kg 这样的值，该列就使用渲染器的默认对齐方式。 |
|---|---|
| 默认（不指定）、左对齐、居中、右对齐 | 对所有列使用同一种对齐方式：分隔行中分别写为 ---、:---、:---: 或 ---:。 |
| 保留为 <br> | 单元格内的换行变成 <br>，GitHub 和大多数渲染器会把它显示为单元格内的新行。这是默认选项。 |
| 替换为空格 | 每个换行都变成一个空格，适用于会过滤 HTML 的渲染器。 |
| 转义 Markdown 符号 | 默认开启。*、_、[、]、<、>、#、~ 和反引号前会加上反斜杠，这样 *fast* 或 <b> 这样的值会按输入的样子显示，而不会变成格式或 HTML。只有当单元格中确实是需要渲染的 Markdown 时才关闭它。 |
| 在源文本中对齐各列 | 默认开启。用空格填充单元格，让原始 .md 文件读起来也像一张网格。中文、日文、韩文等全角字符按两个字符宽度计算。关闭后输出最小，渲染出的表格看起来完全一样。 |
特殊数据如何处理
- 即使关闭了 转义 Markdown 符号，竖线和反斜杠也始终会被转义（
\|、\\），因为未转义的|会开始一个新单元格。 - 带引号的逗号和换行按 RFC 4180 读取，所以
"Cable tidy, 3-pack"会留在同一个单元格中。包含换行的值的数量会显示在预览上方的提示中。 - 值按文本写出：
00731保留前导零，34.90保留末尾的零。不会进行任何四舍五入或重新格式化。 - 空白表头会变成
Column 3，重复表头变成name (2)，确保每一列都有不同的标题。 - Markdown 渲染器会去掉单元格首尾的空格，表格中也不能包含列表或段落；这类内容请放在单独的文档中。
常见问题排查
- 表格后面的文字并到了最后一行里。 表格只有遇到空行或另一个块的开头才会结束，所以请在表格后面留一个空行。
- 所有值都在同一列中。 分隔符识别错了。请在导入设置中选择逗号、分号、制表符或竖线，然后重新打开文件。
- **结果中的 * 或 _ 前面出现了反斜杠。** 这是转义在起作用，只是所用的渲染器没有处理它。如果数据中没有需要保护的格式符号，请关闭“转义 Markdown 符号”。
- 换行显示成了字面上的标签。 渲染器不允许 HTML。请在“单元格内换行”下选择“替换为空格”。
限制与隐私
25 MB、10 万行或 200 万个单元格以内的文件可实时预览前 200 行。更大的文件以流式方式转换：文件分块读取两遍（第一遍测量各列及其宽度，第二遍写出），提示会说明下载内容包含整个文件，并且不提供 复制。单个输出文件最大 4 GB。
转换在当前标签页的后台线程中进行，所以页面保持流畅，点击 取消 即可停止。CSV 文件不会发送到任何服务器。如果想在转换前检查大文件，可以在 CSV 在线查看 中打开它。
示例
一份商品清单，包含带前导零的 SKU、名称中的竖线、引号内的逗号和一条两行的备注，使用默认设置转换。price 列右对齐，因为每个值都是数字；sku 列没有右对齐，因为 00731 被保留为文本。
sku,name,price,note 00731,"Desk lamp | brass",34.90,"Ships in 2 days from Leeds" 00732,"Cable tidy, 3-pack white",4.50,Back-ordered until 14 March 2025 00733,USB-C hub,129.00,
| sku | name | price | note | | ----- | ------------------------ | -----: | -------------------------------- | | 00731 | Desk lamp \| brass | 34.90 | Ships in 2 days<br>from Leeds | | 00732 | Cable tidy, 3-pack white | 4.50 | Back-ordered until 14 March 2025 | | 00733 | USB-C hub | 129.00 | |
常见问题
输出的表格能在 GitHub 上使用吗？
能。它是 GitHub Flavored Markdown 的竖线表格：一行表头、一行可带对齐冒号的分隔行，以及每条 CSV 记录一行。GitLab、Obsidian 和大多数静态网站生成器都能识别同样的语法。
为什么源文本里有 `\|`？
在 Markdown 表格中，普通的 | 表示单元格结束。反斜杠告诉渲染器把竖线当作文本显示，所以 Desk lamp | brass 会留在同一个单元格中。
能把 Markdown 表格转回 CSV 吗？
这个页面不行。它只能把 CSV 和 TSV 转换为 Markdown。