本指南说明如何在 Discourse 帖子中使用 Markdown 添加表格。
所需用户级别：所有用户
在帖子中添加表格有助于以结构化且易于阅读的格式呈现数据。本指南将引导您了解如何在 Discourse 上使用 Markdown 创建表格，涵盖表格基础知识、对齐方式以及添加表情符号和图像等特殊功能。
使用表格生成器
Discourse 包含一个内置的 表格生成器 (Table Builder)，它允许您使用类似电子表格的界面创建和编辑表格——无需了解 Markdown 知识。
要插入新表格：
- 打开编辑器
- 点击工具栏中的
按钮（选项菜单） - 选择 插入表格 (Insert table)
- 使用电子表格编辑器添加标题和数据
- 点击 生成表格 (Build Table) 将生成的 Markdown 表格插入到您的帖子中
要编辑帖子中现有的表格，请点击出现在表格上方的 
编辑表格 (Edit Table) 按钮（拥有编辑权限的用户可见）。这将打开相同的电子表格编辑器，其中预先填充了表格数据。
创建一个简单的表格
使用 Markdown 在 Discourse 中创建表格非常直接。以下是分步指南：
- 首先定义标题行：
- 表格的第一行将包含每列的标题。
- 第二行将标题行与表格的其余部分分开。
以下是一个包含三列的表格示例：
| Col A | Col B | Col C |
|---|---|---|
这将生成：
| Col A | Col B | Col C |
|---|
- 添加数据行：
- 每行都以
|字符开始和结束。 - 确保列数与标题行中的列数匹配。
示例：
| Col A | Col B | Col C |
|---|---|---|
| A1 | B1 | C1 |
| A2 | B2 | :smile: |
这将生成：
| Col A | Col B | Col C |
|---|---|---|
| A1 | B1 | C1 |
| A2 | B2 |  |
对齐方式
您可以使用冒号 (:) 控制列内容的对齐方式：
- 左对齐：
|:---| - 居中对齐：
|:---:| - 右对齐：
|---:|
示例：
| Left | Center | Right |
|:---|:---:|---:|
| My content is on the left | I'm the center of the world | I like being on the right side |
| :waxing_gibbous_moon: | :full_moon: | :waning_gibbous_moon: |
这将生成：
| Left | Center | Right |
|---|---|---|
| My content is on the left | I’m the center of the world | I like being on the right side |
 |
 |
 |
表格中的可点击链接
在表格中添加可点击链接对于将用户引导至特定资源或外部内容非常有用。
要包含可点击链接，请在表格单元格内使用标准的 Markdown 链接语法。格式为 [链接文本](URL)。
示例：
| Column A | Column B | Column C |
|---|---|---|
| [Google](https://www.google.com) | Example Text | Another Link |
这将生成：
| Column A | Column B | Column C |
|---|---|---|
| Example Text | Another Link |
表格中的图像
要在表格中使用图像，在上传图像后，您需要在图像代码中管道符 | 前使用转义字符 \。
示例：
Image | Description
---|---
 | A Chihuahua enjoying espresso in a cafe.
这将生成：
表格中的可点击图像
要使图像可点击，您可以将图像 Markdown 语法嵌套在链接 Markdown 语法中。基本格式如下：
[](link URL)
alt text 对于可访问性很重要，因为它可以在图像未加载或被屏幕阅读器使用时描述图像。请始终使用有意义的替代文本。
以下是如何将可点击图像合并到 Markdown 表格中的方法：
| Image 1 |
|---|
| [](https://meta.discourse.org/)
这将生成：
| Image 1 |
|---|
 |
复制粘贴表格
您可以从外部文档或电子表格中复制表格并直接粘贴到帖子中，Discourse 会自动将其转换为 Markdown。
如果您经常创建表格，也可以使用 TableConvert 等工具将其他格式（CSV、JSON 等）的表格转换为 Markdown。
