表格语法 #

概述 #

表格用于展示结构化数据，Markdown 使用竖线 | 和连字符 - 创建表格。

基本语法 #

markdown

| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |

渲染效果：

列1	列2	列3
数据1	数据2	数据3
数据4	数据5	数据6

表格结构 #

表头 #

第一行是表头：

markdown

| 姓名 | 年龄 | 城市 |
|------|------|------|

分隔行 #

第二行使用 - 分隔表头和内容：

markdown

|------|------|------|

数据行 #

后续行是表格数据：

markdown

| 张三 | 25 | 北京 |
| 李四 | 30 | 上海 |

对齐方式 #

左对齐 #

markdown

| 列名 |
|:------|
| 内容 |

右对齐 #

markdown

| 列名 |
|------:|
| 内容 |

居中对齐 #

markdown

| 列名 |
|:------:|
| 内容 |

对齐示例 #

markdown

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容1 | 内容2 | 内容3 |
| 长内容 | 中 | 短 |

渲染效果：

左对齐	居中对齐	右对齐
内容1	内容2	内容3
长内容	中	短

表格格式化 #

简洁格式 #

竖线两端可以省略：

markdown

列1 | 列2 | 列3
----|------|----
数据1 | 数据2 | 数据3

完整格式 #

推荐使用完整格式，更易读：

markdown

| 列1 | 列2 | 列3 |
|-----|------|------|
| 数据1 | 数据2 | 数据3 |

对齐格式 #

列宽可以不一致：

markdown

| 名称 | 描述 |
|------|--------------------------|
| A | 这是一个很长的描述内容 |
| B | 短描述 |

表格中的内容 #

文本内容 #

markdown

| 项目 | 状态 |
|------|------|
| 开发中 | 进行中 |
| 已完成 | 已上线 |

数字内容 #

markdown

| 产品 | 价格 | 库存 |
|------|------|------|
| 商品A | 99.00 | 100 |
| 商品B | 199.00 | 50 |

链接 #

markdown

| 网站 | 地址 |
|------|------|
| GitHub | [github.com](https://github.com) |
| Google | [google.com](https://google.com) |

行内代码 #

markdown

| 方法 | 说明 |
|------|------|
| `map()` | 映射数组 |
| `filter()` | 过滤数组 |
| `reduce()` | 归约数组 |

强调 #

markdown

| 状态 | 说明 |
|------|------|
| **高** | 紧急处理 |
| *中* | 正常处理 |
| 低 | 延后处理 |

表格限制 #

不支持的功能 #

合并单元格
多行表头
表格嵌套
复杂样式

解决方案 #

使用 HTML 表格：

markdown

<table>
  <tr>
    <th colspan="2">合并单元格</th>
  </tr>
  <tr>
    <td>数据1</td>
    <td>数据2</td>
  </tr>
</table>

实际应用 #

API 参数表 #

markdown

## API 参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| id | string | 是 | 用户ID |
| name | string | 否 | 用户名 |
| age | number | 否 | 年龄 |
| email | string | 是 | 邮箱地址 |

技术对比表 #

markdown

## 框架对比

| 特性 | React | Vue | Angular |
|------|-------|-----|---------|
| 学习曲线 | 中 | 低 | 高 |
| 性能 | 高 | 高 | 中 |
| 生态系统 | 丰富 | 丰富 | 完整 |
| TypeScript | 支持 | 支持 | 默认 |

版本历史 #

markdown

## 版本历史

| 版本 | 日期 | 更新内容 |
|------|------|----------|
| v1.0.0 | 2024-01-01 | 首次发布 |
| v1.1.0 | 2024-02-01 | 新增功能 |
| v2.0.0 | 2024-03-01 | 重大更新 |

配置说明 #

markdown

## 配置项

| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| `port` | 3000 | 服务端口 |
| `host` | localhost | 服务地址 |
| `debug` | false | 调试模式 |

表格最佳实践 #

1. 保持列宽合理 #

markdown

好的：
| 名称 | 说明 |
|------|------|
| A | 简短说明 |

不好的：
| 名称 | 说明 |
|------|------|
| A | 这是一个非常非常长的说明内容，导致表格难以阅读 |

2. 使用对齐增强可读性 #

markdown

| 数字列 | 文字列 |
|-------:|:-------|
| 100 | 左对齐文字 |
| 200 | 更易阅读 |

3. 表格前后空行 #

markdown

这是说明文字。

| 表格 |
|------|
| 数据 |

这是后续内容。

4. 复杂数据使用列表 #

当数据过于复杂时，考虑使用列表：

markdown

好的：
- **用户信息**
  - 姓名：张三
  - 年龄：25
  - 城市：北京

不好的：
| 属性 | 值 |
|------|-----|
| 姓名 | 张三 |
| 年龄 | 25 |
| 城市 | 北京 |

常见问题 #

问题1：表格不显示 #

检查：

分隔行是否正确
竖线数量是否一致
是否有空行分隔

问题2：对齐不生效 #

markdown

正确：|:------|
错误：|:----- |（冒号位置错误）

问题3：表格中包含竖线 #

需要转义：

markdown

| 表达式 | 结果 |
|---------|------|
| a \| b | 或运算 |

下一步 #

继续学习表格对齐！