07 表格与任务列表

表格

Markdown 表格由两行组成：表头行 + 分隔行，之后是数据行。

| 名称 | 版本 | 说明 |
| --- | --- | --- |
| Forge | 47.4.23 | 模组加载器 |
| Java | 17 | 运行环境 |

渲染：

名称	版本	说明
Forge	47.4.23	模组加载器
Java	17	运行环境

要点

1. 分隔行不能省：没有 | --- | --- | 这一行，表格不成立（这条是最常见的错）。
2. 竖线两边的空格可有可无，加空格更好读：
3. 紧凑：|名称|版本|
4. 松散（推荐）：| 名称 | 版本 |
5. 分隔行至少三个短横线：---、---- 都行，-- 不行。
6. 列数要对齐，某行多一列会渲染异常。

对齐方式

在分隔行里加冒号控制对齐：

| 左对齐 | 居中 | 右对齐 |
| :--- | :---: | ---: |
| 文字 | 文字 | 1234 |
| 长一点的文字 | 中 | 56 |

左对齐	居中	右对齐
文字	文字	1234
长一点的文字	中	56

写法	效果
:---	左对齐
:---:	居中
---:	右对齐
---	默认（左对齐）

💡 数字列建议右对齐（:---: 居中或 ---: 右对齐），看数字时不累眼。

表格里放其它内容

想放的东西	写法
粗体/斜体	直接 **粗体**
行内代码	直接 `code`
链接	直接 [文字](地址)
换行	用 <br>（表格里不能靠空行换行）
竖线本身	转义 \|

例子：

| 项目 | 状态 |
| --- | --- |
| 考试系统 | ✅ 正常 |
| 文档站 | ✅ 正常 |
| 待办 | 见 [规划](10-mkdocs.md) |

项目	状态
考试系统	✅ 正常
文档站	✅ 正常
待办	见 规划

什么时候别用表格

• 手机上：宽表格会左右滚动，列超过 4 列就难受
• 聊天软件：Discord、WhatsApp、QQ 不渲染表格，会变成一堆竖线 → 改用无序列表
• 内容很长：每格一大段话时，用「小标题 + 列表」更好读

任务列表（复选框）

语法是 - [ ]（未完成）和 - [x]（已完成）——方括号里要有空格或 x：

- [x] 搭建文档站
- [x] 写 Markdown 教程
- [ ] 加 AI 问答
- [ ] 写宣传文案

渲染：

• 搭建文档站
• 写 Markdown 教程
• 加 AI 问答
• 写宣传文案

注意：这是 GFM 扩展语法，不是所有平台都支持。

平台	支持任务列表
GitHub / Gitee	✅
Obsidian / Typora / VS Code	✅（可点击勾选）
MkDocs Material	✅（需 pymdownx.tasklist 扩展）
语雀 / 飞书	✅
QQ / Discord 聊天	❌（当普通列表显示）

任务列表也支持嵌套：

- [ ] 上线新赛季
  - [x] 配好活动日历
  - [ ] 发布枪皮

• 上线新赛季
• 配好活动日历
• 发布枪皮

常见的「表格坏了」

现象	原因	解决
表格变一堆竖线文字	缺分隔行	补 \| --- \| --- \|
表格只渲染出第一行	数据行列数和表头不一致	补齐竖线
单元格内容被切开	内容里用了裸 \|	写成 \\\|
复选框变成 - [ ] 文字	平台不支持任务列表	改用普通列表或 Emoji ✅⬜
表格在手机上超宽	列太多/内容太长	拆表或改列表

本章练习

1. 做一个三列三行的表格（模组名 / 版本 / 用途）。
2. 让第二列居中对齐。
3. 写一个四级任务列表，勾掉其中两条。

下一章进入进阶语法：折叠块、脚注、Emoji、HTML 混排。