# 表格

您可以在 GitBook 页面中添加表格，以更好地组织信息。您可以在下面的示例表格中看到可实现效果的示例：

<table data-full-width="false"><thead><tr><th>公司</th><th>状态<select><option value="36bef47f343d4588bc43db3e5c701796" label="进行中" color="blue"></option></select></th><th>联系</th><th>月经常性收入</th><th data-hidden>联系</th><th data-hidden>月经常性收入</th><th data-hidden>状态<select><option value="3e7a52c673ec4a01992566d18271f7a5" label="进行中" color="blue"></option><option value="2362fd3eafc7476fb8646ac754f34b72" label="已完成" color="blue"></option></select></th></tr></thead><tbody><tr><td><strong>Ace AI</strong> – 设计</td><td><span data-option="36bef47f343d4588bc43db3e5c701796">进行中</span></td><td><a href="mailto:noreply@gitbook.com">rena@ace.ai</a></td><td>$450</td><td><a href="mailto:noreply@gitbook.com">rena@ace.ai</a></td><td>$420</td><td><span data-option="3e7a52c673ec4a01992566d18271f7a5">进行中</span></td></tr><tr><td><strong>Discrete Data</strong> – API</td><td><span data-option="36bef47f343d4588bc43db3e5c701796">进行中</span></td><td><a href="mailto:noreply@gitbook.com">dave@dd.inc</a></td><td>$100</td><td><a href="mailto:noreply@gitbook.com">dave@dd.inc</a></td><td>$69</td><td></td></tr><tr><td><strong>Example Co</strong></td><td></td><td><a href="mailto:pete@example.com">pete@example.com</a></td><td>$50</td><td></td><td></td><td></td></tr></tbody></table>

### 表格块选项

当你打开表格块左侧的“选项”菜单时，你会看到多个选项，可用于更改外观并管理表格中的数据：

* **表格/卡片：** 选择将数据显示为表格块或 [卡片块](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/creating-content/blocks/cards)。GitBook 使用相同的数据填充这两种块，因此你可以根据想要的外观和设计在它们之间切换。
* **添加列：** 在表格右侧添加一个新列。你可以使用菜单选择列类型，或者直接点击 **添加列** 来添加文本列。
* **插入行：** 在表格底部添加一新行。
* **显示表头：** 隐藏或显示表格顶部的标题行。
* **冻结表头：** 在你滚动下方各行时，让表格顶部行始终显示在页面上。这对于较大的表格很有用，因为你希望列标题始终可见。
* **重置列大小：** 如果你已更改列宽，这将把它们全部重置为相等。
* **可见列：** 选择哪些列可见、哪些列隐藏。如果你的表格中有隐藏列，可以在此菜单中将它们重新显示。
* **全宽：** 让表格占满窗口的整个宽度。这对于包含很多列的表格非常有用。
* **删除：** 删除表格块及其所有内容。

### 更改列类型

根据你想显示的数据，可以为表格列设置不同的数据类型。这些类型会为该列中的每个单元格添加格式、装饰或限制：

* **文本：** 标准文本列，支持标准格式。
* **数字：** 数字列，可带或不带小数位。
* **复选框：** 每一行都有一个可勾选或取消勾选的复选框。
* **选择：** 你可以从选项列表中选择数据，这些选项可通过打开 **列选项** 菜单并选择 **管理选项**来定义。这可以是单选或多选。
* **用户：** 你可以添加组织成员的姓名和头像。这可以是单选或多选。
* **文件：** 你可以引用空间中的文件。在填充该列单元格时，你可以上传新文件。
* **评分：** 星级评分。你可以通过打开 **列选项** 菜单并选择 **最大值**.

使用 **列选项** 菜单更改列类型。当你更改列类型时，会看到一个提示，要求你确认更改，因为此操作可能会删除或破坏列数据。

### 调整列宽

将鼠标悬停在列边缘并拖动即可调整大小。光标上方会显示像素数，以帮助你设置一致的列大小。

GitBook 会将列大小按整体宽度的百分比存储，从而允许根据表格的整体宽度进行相对调整。

### 可滚动表格

比编辑器容器更宽的表格将可以水平滚动。

### 列选项

要重新排序列，请点击并拖动你想移动的列顶部的拖拽手柄 <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FPnnI41SqLSaKBNwT98fW%2Factions-horizontal.svg?alt=media&#x26;token=99754200-a354-4ffe-931e-aa6322ea7395" alt="The table drag handle icon in GitBook"></picture> 。

你可以通过点击 **添加列** 按钮来添加新列，该按钮会在你将鼠标悬停于表格右边缘时出现。

在 **列选项** 菜单中，你还可以切换自动调整大小的开关、在右侧添加新列、隐藏该列或删除该列。

### 行选项

将鼠标悬停在行上并点击其左侧出现的 **行选项** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Row options menu icon in GitBook"></picture> 按钮以打开 **行选项** 菜单。你会看到多个选项：

* **打开行：** 在一个模态窗口中打开该行，显示其全部数据。在这里你可以快速更改行类型、编辑数据，并查看隐藏列中的数据。
* **在上方/下方插入：** 在当前选中的行上方或下方添加一新行。
* **添加列：** 在表格右侧添加一个新列。
* **删除行：** 永久移除表格中该行的所有数据。

### 表格中的图片

当你点击表格单元格时，可以按 / 键插入图片。图片不能添加到表格的表头行。

### 在 Markdown 中的表示

```markdown
# 表格

|   |   |   |
| - | - | - |
|   |   |   |
|   |   |   |
|   |   |   |
```

<details>

<summary>我可以在 GitBook 中创建嵌套表格吗？</summary>

GitBook 中不支持嵌套表格。为了确保文档保持易于编写、可靠渲染，并且对所有用户都可访问，GitBook 保持表格为扁平结构。

一旦表格位于另一个表格单元格中，就会变得难以编辑、调整大小、导航，或者在不同设备间保持一致的格式。

嵌套表格还会给底层文档结构带来显著复杂性，往往会破坏清晰的语义，并导致诸如 Git Sync 之类的功能出现不可预测的行为。

</details>
