Markdown 表格完整教程
表格是 Markdown 最实用、也最容易写错的语法之一。本文从基本格式开始,一路整理到对齐、换行、特殊符号与 Excel 转换。想边看边试,打开 Markdown 在线编辑器,粘贴示例就能实时看到效果。
基本语法
表格由三部分组成:表头、分隔行、数据行。列之间用 | 隔开。
| 姓名 | 部门 | 分机 |
| --- | --- | --- |
| 王小明 | 销售部 | 101 |
| 陈美玲 | 设计部 | 205 |
显示效果:
| 姓名 | 部门 | 分机 |
|---|---|---|
| 王小明 | 销售部 | 101 |
| 陈美玲 | 设计部 | 205 |
要点:
- 第二行的
---不能省略,每列至少三个-。 - 首尾的
|可以省略,但保留更易读。 - 每行的列数要和表头一致。
- 表格前后要空一行,否则可能被当成普通文字。
列对齐
在分隔行加上冒号 : 控制对齐:
| 左对齐 | 居中 | 右对齐 |
| :--- | :---: | ---: |
| 苹果 | 10 | ¥30 |
| 香蕉 | 5 | ¥15 |
| 左对齐 | 居中 | 右对齐 |
|---|---|---|
| 苹果 | 10 | ¥30 |
| 香蕉 | 5 | ¥15 |
数字、金额建议右对齐,方便比较大小。
单元格里放代码、链接与加粗
单元格里可以使用行内语法:
| 命令 | 说明 |
| --- | --- |
| `npm install` | 安装依赖,见[官方文档](https://docs.npmjs.com/) |
| **必填** | 这个字段一定要填 |
单元格里要显示“|”
竖线会被当成列分隔符,要在前面加反斜杠:
| 运算符 | 含义 |
| --- | --- |
| `a \| b` | 按位或 |
单元格内换行
标准 Markdown 表格不支持在单元格内换行,每一行必须写在同一行里。常见做法:
- GitHub:可以写
<br>换行,例如第一行<br>第二行。 - 墨阅:出于安全考虑不执行 HTML 标签,
<br>会原样显示。建议拆成多行,或改用列表呈现。
合并单元格
标准 Markdown 表格无法合并单元格。替代做法:
- 重复填写相同内容,让表格保持规整。
- 把表格拆成两个较小的表格。
- 内容复杂时,改用列表或小标题分段,通常更好读。
从 Excel、WPS 表格转成 Markdown 表格
表格直接复制粘贴会变成用 Tab 分隔的文字。转换方法:
- 用文本编辑器把 Tab 替换成
|,并在每行首尾补上|,再加上分隔行。 - 或使用网上的“Excel 转 Markdown”工具。
转好之后粘贴到在线编辑器检查列是否对齐。
宽表格的阅读
列很多的表格在手机上会超出屏幕。墨阅会让表格可以左右滚动,不会挤压整个版面。写作时也可以:
- 去掉不重要的列。
- 把长文字改成简短关键词,细节写在表格下方。
速查模板
| 项目 | 数量 | 金额 |
| :--- | ---: | ---: |
| 项目一 | 1 | 100 |
| 项目二 | 2 | 250 |
| **合计** | **3** | **350** |
更多语法请看 Markdown 语法教程;要把表格做成报告,可以参考 Markdown 转 PDF。