For the complete documentation index, see llms.txt. This page is also available as Markdown.

表格

使用表格保持信息有序,并让数据文档化更轻松

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

公司
状态
联系方式
MRR

Ace AI – 设计

进行中

rena@ace.ai

$450

Discrete Data – API

进行中

dave@dd.inc

$100

Example Co

pete@example.com

$50

表格块选项

当您打开表格块左侧的“选项”菜单时,您将看到一系列可用于更改外观和管理表格内数据的选项:

  • 表格/卡片: 选择将数据显示为表格块或卡片块。GitBook 使用相同的数据填充这两种块,因此您可以根据想要的外观和设计在它们之间切换。

  • 添加列: 在表格右侧添加一个新列。您可以使用菜单选择列类型,或者直接点击 添加列 来添加文本列。

  • 插入行: 在表格底部添加一新行。

  • 显示表头: 隐藏或显示表格顶部的标题行。

  • 冻结表头: 在您滚动下方各行时,保持表格顶部行在页面中可见。这对于较大的表格很有用,因为您希望列标题始终保持可见。

  • 冻结第一列: 在您水平滚动右侧列时,保持表格最左侧的列可见。这对于超出页面宽度的更宽表格很有用,您希望行标签或标识符始终保持可见。

  • 重置列宽: 如果您更改了列宽,这将把它们全部重置为相同宽度。

  • 可见列: 选择哪些列可见、哪些列隐藏。如果您的表格中有隐藏列,可以在此菜单中将它们重新显示。

  • 删除: 删除表格块及其所有内容。

合并单元格

通过拖动选择多个单元格,或者按住 Shift 并按箭头键来选择多个单元格。使用选择单元格后出现的把手来合并它们。

合并适用于 文本 和 数字 单元格。GitBook 会对不受支持的字段、混合字段类型、锚定单元格外的注释以及卡片视图阻止合并。GitBook 还会阻止对已合并单元格或包含已合并单元格的行进行重新排序。

合并在使用 Git Sync 时采用原生 colspan 和 rowspan 。合并是基于位置的:锚定单元格和跨列/跨行范围遵循表格当前的行顺序和可见列顺序。

第一版不支持矩形合并,例如 2x2 的选择。合并单元格时,请选择要保留的值。GitBook 会清除其他值。取消合并不会恢复已清除的值。

更改列类型

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

  • 文本: 标准文本列,支持标准格式。

  • 数字: 数值列,可带或不带小数位。

  • 复选框: 每行一个可勾选或取消勾选的复选框。

  • 选择: 您可以通过打开 列选项 菜单并选择 管理选项来从您定义的选项列表中选择数据。这可以是单选或多选。

  • 用户: 您可以添加组织中某位成员的姓名和头像。这可以是单选或多选。

  • 文件: 引用该部分中的某个文件。在填充该列的单元格时,您可以上传新文件。

  • 评分: 星级评分。您可以通过打开 列选项 菜单并选择 最大值.

使用 列选项 菜单来更改列类型。当您更改列类型时,系统会提示您确认更改,因为此操作可能会删除或破坏列数据。

调整列宽

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

GitBook 会将列宽存储为整体宽度的百分比,这样即可根据表格总宽度进行相对缩放。

可滚动表格

宽度超过编辑器容器的表格将可水平滚动。

列选项

要重新排序列,请点击并拖动 The table drag handle icon in GitBook 位于您想移动的列顶部的拖动手柄。

您可以通过点击 添加列 当您将鼠标悬停在表格右边缘时出现的按钮来添加新列。

在 列选项 菜单中,您还可以打开或关闭自动调整大小、在右侧添加新列、隐藏该列或删除该列。

行选项

将鼠标悬停在该行上并点击 行选项 The Row options menu icon in GitBook 左侧出现的按钮以打开 行选项 菜单。您将看到一系列选项:

  • 打开行: 在一个模态窗口中打开该行,显示其全部数据。在这里您可以快速更改行类型、编辑数据,并查看隐藏列中的数据。

  • 在上方/下方插入: 在当前选中行的上方或下方添加新行。

  • 添加列: 在表格右侧添加新列。

  • 删除行: 从您的表格中永久移除该行中的所有数据。

表格中的图片

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

Markdown 中的表示

我可以在 GitBook 中创建嵌套表格吗?

在 GitBook 中无法嵌套表格。为确保文档易于编写、渲染可靠,并且所有用户都能访问,GitBook 保持表格为扁平结构。

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

嵌套表格还会给底层文档结构带来显著复杂性,常常破坏简洁语义,并导致诸如 Git Sync 之类功能的不确定性。

最后更新于

这有帮助吗?