什么是 Markdown 表格What Is a Markdown Table
Markdown 是写文档、README、Wiki 与笔记最常用的轻量格式。它的表格用 | 分隔列,用一行 --- 作为表头分隔:
Markdown is the lightweight format for docs, READMEs, Wikis and notes. Its tables use | between columns and a --- row under the header:
| 姓名 | 城市 |
| --- | --- |
| 张三 | 北京 |
| 李四 | 上海 |
为什么转 MarkdownWhy Convert to Markdown
- 把数据库导出的 CSV 直接贴进 GitHub / GitLab README、Confluence、Notion。
- 比截图表格可检索、可复制、可版本管理。
- 写技术文档、接口说明、对比表时,表格比纯文本清晰。
- Paste a DB-exported CSV straight into a GitHub/GitLab README, Confluence or Notion.
- More searchable, copyable and version-controllable than a screenshot.
- Clearer than plain text for tech docs, API specs and comparison tables.
对齐与转义Alignment & Escaping
- 竖线
|:单元格内容里的|必须写成\|,否则会被当成列边界。 - 换行:Markdown 表格单元格内不支持硬换行,多行内容需先合并或用
<br>。 - 对齐:表头分隔行写
:---(左)、:---:(中)、---:(右)可控制对齐。
- Pipes
|: a|inside a cell must be written\|or it splits the column. - Newlines: hard line breaks aren't supported inside a cell; merge lines or use
<br>. - Alignment:
:---(left),:---:(center),---:(right) in the divider row.
提示:字段与分隔符基础可先看 分隔符与引号;要把表格结构化后再转 Markdown,可先用 CSV 转 JSON 理清结构。
Tip: For field/delimiter basics see delimiters & quoting; to structure data before Markdown, try CSV to JSON first.
在线转换的步骤Steps to Convert Online
- 打开 365Lab CSV 工具箱 的转换功能,拖入 CSV。
- 选择目标格式为「Markdown」。
- 确认是否需要表头、对齐方式,点击转换。
- 复制生成的 Markdown 表格,粘贴进你的文档。
- Open the 365Lab CSV Toolkit converter and drop in your CSV.
- Pick "Markdown" as the target format.
- Confirm header and alignment options, then convert.
- Copy the generated Markdown table into your doc.
常见坑Common Pitfalls
- 忘记转义
|,导致列数突变。 - 单元格内换行被吞掉,需先清洗(见 CSV 数据清洗)。
- 超大表(上千行)贴进文档会变卡,建议拆表或只贴摘要。
- Forgetting to escape
|, causing column count to jump. - In-cell newlines get dropped — clean first (see CSV cleaning).
- Very large tables (thousands of rows) lag the editor — split or summarize.
想马上生成表格?打开在线转换工具,拖入 CSV 即得 Markdown,全程本地处理、不上传服务器。
Want to generate a table now? Open the converter, drop in your CSV to get Markdown — all local.