什么是 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

  1. 打开 365Lab CSV 工具箱 的转换功能,拖入 CSV。
  2. 选择目标格式为「Markdown」。
  3. 确认是否需要表头、对齐方式,点击转换。
  4. 复制生成的 Markdown 表格,粘贴进你的文档。
  1. Open the 365Lab CSV Toolkit converter and drop in your CSV.
  2. Pick "Markdown" as the target format.
  3. Confirm header and alignment options, then convert.
  4. 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.

打开 CSV 转换工具 →Open the CSV Converter →