> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/blocks/table.md).
# 表格
使用表格保持信息有序，并让数据文档化更轻松
您可以在 GitBook 页面中添加表格，以更好地组织信息。您可以在下面的示例表格中查看可实现效果的示例：
### 表格块选项
当您打开表格块左侧的“选项”菜单时，您将看到一系列可用于更改外观和管理表格内数据的选项：
* **表格/卡片：** 选择将数据显示为表格块或卡片块。GitBook 使用相同的数据填充这两种块，因此您可以根据想要的外观和设计在它们之间切换。
* **添加列：** 在表格右侧添加一个新列。您可以使用菜单选择列类型，或者直接点击 **添加列** 来添加文本列。
* **插入行：** 在表格底部添加一新行。
* **显示表头：** 隐藏或显示表格顶部的标题行。
* **冻结表头：** 在您滚动下方各行时，保持表格顶部行在页面中可见。这对于较大的表格很有用，因为您希望列标题始终保持可见。
* **冻结第一列：** 在您水平滚动右侧列时，保持表格最左侧的列可见。这对于超出页面宽度的更宽表格很有用，您希望行标签或标识符始终保持可见。
* **重置列宽：** 如果您更改了列宽，这将把它们全部重置为相同宽度。
* **可见列：** 选择哪些列可见、哪些列隐藏。如果您的表格中有隐藏列，可以在此菜单中将它们重新显示。
* **删除：** 删除表格块及其所有内容。
### 合并单元格
通过拖动选择多个单元格，或者按住 Shift 并按箭头键来选择多个单元格。使用选择单元格后出现的把手来合并它们。
合并适用于 **文本** 和 **数字** 单元格。GitBook 会对不受支持的字段、混合字段类型、锚定单元格外的注释以及卡片视图阻止合并。GitBook 还会阻止对已合并单元格或包含已合并单元格的行进行重新排序。
合并在使用 Git Sync 时采用原生 `colspan` 和 `rowspan` 。合并是基于位置的：锚定单元格和跨列/跨行范围遵循表格当前的行顺序和可见列顺序。
第一版不支持矩形合并，例如 `2x2` 的选择。合并单元格时，请选择要保留的值。GitBook 会清除其他值。取消合并不会恢复已清除的值。
### 更改列类型
根据您要显示的数据，您可以为表格列设置不同的数据类型。这些类型会为该列中的每个单元格添加格式、装饰或限制：
* **文本：** 标准文本列，支持标准格式。
* **数字：** 数值列，可带或不带小数位。
* **复选框：** 每行一个可勾选或取消勾选的复选框。
* **选择：** 您可以通过打开 **列选项** 菜单并选择 **管理选项**来从您定义的选项列表中选择数据。这可以是单选或多选。
* **用户：** 您可以添加组织中某位成员的姓名和头像。这可以是单选或多选。
* **文件：** 引用该部分中的某个文件。在填充该列的单元格时，您可以上传新文件。
* **评分：** 星级评分。您可以通过打开 **列选项** 菜单并选择 **最大值**.
使用 **列选项** 菜单来更改列类型。当您更改列类型时，系统会提示您确认更改，因为此操作可能会删除或破坏列数据。
### 调整列宽
将鼠标悬停在列边缘并拖动以调整大小。光标上方会显示像素数，帮助您设置一致的列宽。
GitBook 会将列宽存储为整体宽度的百分比，这样即可根据表格总宽度进行相对缩放。
### 可滚动表格
宽度超过编辑器容器的表格将可水平滚动。
### 列选项
要重新排序列，请点击并拖动 位于您想移动的列顶部的拖动手柄。
您可以通过点击 **添加列** 当您将鼠标悬停在表格右边缘时出现的按钮来添加新列。
在 **列选项** 菜单中，您还可以打开或关闭自动调整大小、在右侧添加新列、隐藏该列或删除该列。
### 行选项
将鼠标悬停在该行上并点击 **行选项** 左侧出现的按钮以打开 **行选项** 菜单。您将看到一系列选项：
* **打开行：** 在一个模态窗口中打开该行，显示其全部数据。在这里您可以快速更改行类型、编辑数据，并查看隐藏列中的数据。
* **在上方/下方插入：** 在当前选中行的上方或下方添加新行。
* **添加列：** 在表格右侧添加新列。
* **删除行：** 从您的表格中永久移除该行中的所有数据。
### 表格中的图片
当您点击表格单元格时，可以按 / 键插入图片。图片不能添加到表格的表头行。
### Markdown 中的表示
```markdown
# 表格
| | | |
| - | - | - |
| | | |
| | | |
| | | |
```
我可以在 GitBook 中创建嵌套表格吗？
在 GitBook 中无法嵌套表格。为确保文档易于编写、渲染可靠，并且所有用户都能访问，GitBook 保持表格为扁平结构。
一旦表格位于另一个表格单元格中，编辑、调整大小、导航或在不同设备间保持一致格式都会变得困难。
嵌套表格还会给底层文档结构带来显著复杂性，常常破坏简洁语义，并导致诸如 Git Sync 之类功能的不确定性。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/blocks/table.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
