实用教程 · 合成示例
将 Excel、CSV 转为 Markdown 表格
试用真实工作簿与 CSV 示例，核对公式、空单元格和分隔符。
电子表格和 Markdown 表格用途不同：Excel 用来计算和排版，Markdown 用来把一份可读的数据快照放进 README、任务说明、笔记或报告。
转换示例工作簿
下载 inventory.xlsx，也可以试同一份数据的 CSV。工作簿只有一个 Inventory 工作表，三列、三行数据。数量以数字保存，备注包含逗号，用于检查 CSV 引号处理。
- 打开 Excel、CSV 转 Markdown。
- 上传工作簿或 CSV，使用普通转换。
- 等待完成后检查全文。XLSX 输出包含工作表标题，CSV 直接输出表格。
- 按需要编辑表格，再复制或下载结果。
示例工作簿的实际输出如下：
## Inventory
| Item | Quantity | Notes |
| --- | --- | --- |
| Notebook | 3 | Recycled paper |
| Pen | 12 | Black, fine tip |
| Total | 15 | NaN |
将它粘贴到 GitHub 的 Markdown 编辑器，或支持 GitHub 风格表格的笔记软件。如果目标编辑器直接显示竖线，先检查它是否支持表格语法。
处理公式和合并单元格
导出的表格是快照，公式不会继续计算，转换器也不会启动 Excel 重新计算工作簿。包含大量公式时，先在 Excel 或 LibreOffice 中重新计算并保存；没有可用缓存值时，可导出只含数值的 CSV，结果更容易核对。
Markdown 普通表格不能等价表达合并单元格、条件格式和背景颜色。建议在源文件副本中明确每列标题，取消只为排版设置的合并单元格。转换后重点核对日期、百分比、总数和带前导零的编号。
注意 CSV 分隔符
将 CSV 保存为 UTF-8。包含逗号的值应带引号，例如 "Black, fine tip"，否则可能被识别成多一列。如果某行错位，检查源文件的分隔符和引号规则；其他分隔符的文件可能需要重新导出为逗号分隔的 CSV。
将电子表格保留为计算源，Markdown 用于说明和审阅。带配图的报告可连同图片一起导出，避免把临时图片链接当作永久笔记附件。
当前 XLSX 转换器可能把空单元格显示为 NaN，示例中已展示。需要空白时，请在 Markdown 编辑器中清空该单元格；CSV 版本会保留这个空字段。若原始数据中 NaN 有实际含义，不要批量删除。