页面

添加页面、页面组或外部链接，并了解每个页面可用的选项

页面是你可以添加、编辑和嵌入内容的地方。页面始终位于某个 空间中，使你能够将相关内容分组，并为你所涵盖的主题或领域创建不同的部分。

当发布你的文档时，每个空间都会成为自己的 文档站点 或 站点部分，空间中的所有页面都会显示在该站点上。

目录

你可以在一个空间中创建任意多的页面。它们都会显示在该空间左侧边栏的 目录中。当你发布空间时，目录也会出现在同样的位置，除非 你选择将其隐藏.

文档站点着陆页

目录中的第一页始终是你空间的着陆页，即使它被从目录中隐藏。

创建新页面

当处于 实时编辑 模式或处于 变更请求中时，你可以通过点击 添加新内容... > 页面 位于目录底部来创建新页面。或者，你也可以将鼠标悬停在目录中的页面之间，并点击出现的 + 图标。

GitBook 中的一个空白页面。你可以在左侧的目录中看到它列出。

看不到创建新页面的选项？

如果 实时编辑 已在你的空间中禁用，你需要创建或编辑一个 变更请求。一旦进入变更请求， 新页面 按钮（可让你创建页面、页面组和链接）就会在目录中可用。

或者，你可能没有正确的 权限 来编辑页面。

组织你的内容

在目录中组织内容有三种方式：

页面

页面有标题、可选描述，以及一个你可以编写并添加各种内容的区域。

你可以通过在目录中将一个页面拖放到另一个页面下方来嵌套页面。这样会创建一个 子页面.

如果你将子页面添加到一个空的父页面下，GitBook 会自动生成一个“内容”页面，其中包含发布版本文档中所有子页面的链接。

提示： 页面嵌套没有限制，但我们建议你避免超过三层嵌套，以免导航过于复杂。

当你更改页面标题时，页面的 slug（URL 最末尾的部分，例如 /hello-world）也会随之更改——除非你之前手动设置过该页面的 slug。

你可以随时通过点击打开页面的 操作菜单 并选择 编辑标题和 slug.

页面链接标题

如果你希望页面拥有更长、更利于 SEO 的标题，同时为导航条目和链接保留较短的标题，你可以选择性地定义一个链接标题。

打开页面的 操作菜单 并选择 编辑标题和 slug。在 编辑页面 对话框中，你会找到启用并为该页面定义链接标题的选项。

如果你正在使用 Git Sync，页面链接标题是在 SUMMARY.md 文件中的页面链接里设置的：

# 目录

* [页面主标题](page.md "页面链接标题")

注意： 页面链接标题会用于目录、每个页面底部的分页按钮，以及你添加到该页面的任何相对链接中。

页面链接标题是可选的——如果你不手动添加，默认会使用页面的标准标题。

页面组

使用页面组，你可以将页面整合到覆盖相关内容的各个部分中。

你可以通过点击 添加新内容... > 分组 来创建一个新页面组，位于目录底部。

页面组只能位于目录的 顶层 。你不能在页面组中再嵌套页面组。

要更改页面组的标题和 slug，请点击目录中该组标题旁边的 操作菜单 图标 并选择 重命名.

外部链接

你也可以在目录中添加链接。点击它们会直接将访问者带到链接内容。

通过点击创建新的外部链接 添加新内容... > 外部链接 来创建一个新页面组，位于目录底部。

页面图标和表情符号

为了让读者在浏览目录时更容易识别，你可以为单个页面添加可选的图标或表情符号。该图标或表情符号会显示在目录中，以及页面顶部标题旁边。

要添加图标或表情符号，请点击 添加图标 按钮（在鼠标悬停于页面标题时显示），或者标题左侧的表情符号按钮。

页面选项

在 页面选项 菜单中，你可以自定义空间中所选页面的外观，并控制其可见性。

布局

你可以将鼠标悬停在页面标题上以打开 页面选项 菜单，或更改页面封面。你会看到按钮出现在页面标题上方。

在 页面选项 侧边面板中，你可以选择每个页面在访问你的 已发布 内容时的显示方式。你可以从三种布局预设中选择，或者创建自定义布局。

每种布局预设都会为以下页面部分分别打开或关闭：

• 页面标题

• 页面描述

• 目录

• 页面大纲

• 下一页/上一页链接

• 页面元数据

• 标签

你可以从 资料库 → 标签为页面添加一个或多个标签。开启 在页面上显示标签 即可将其显示在页面页眉中。你还可以选择一个标签作为页面的主标签。GitBook 可以将它显示在目录中页面旁边。了解更多请见 标签.

你也可以在此菜单中设置页面的全局宽度。选择 宽版 后，表格、卡片和代码块等内容块在页面发布后会获得更大的空间。这非常适合创建引人注目的着陆页。

可见性

你可以决定在已发布的文档中想显示/隐藏哪些页面，同时也可以决定是否希望该页面被纳入已发布文档的搜索中，和/或被搜索引擎索引。

你可以通过打开页面的 操作菜单 并切换 隐藏页面.

被隐藏的页面仅会从已发布的目录中隐藏。

它们仍可通过站点的 MCP 服务器以及 llms-full.txt.

如果启用隐藏，那么在使用 Git Sync 时，Markdown 文件的 front matter 中会显示以下内容：

page.md

---
hidden: true
---

隐藏 页面标题 或 页面描述 仅会隐藏已发布内容中的页面页眉。它不会移除页面正文中的标题。了解有关标题级别的更多信息，请见 标题.

元数据（SEO）

使用 页面选项 → 元数据 来控制搜索引擎如何理解相似页面之间的关系（例如：文档版本或 内容变体).

• 规范 URL: 此页面首选的（权威的）URL。搜索引擎会将其视为“事实来源”。当多个 URL 显示相同内容时使用它。

• 备用 URL: 同一内容在另一变体中的其他 URL。例如，另一个版本或语言。它们有助于搜索引擎对不同变体进行分组，而不是将其视为重复内容。

这两个字段都支持选择 GitBook 中的其他页面（推荐）或输入外部 URL。

版本化文档的常见做法是，将较旧的页面设置为与最新对应页面保持规范一致（例如， 1.0 → 2.0），然后在最新页面上将较旧版本列为备用项。

页面封面

你还可以为文档中的每个页面设置封面。点击 页面封面 选项后，默认封面会立即添加。你可以在这里：

• 更改封面图片

  将鼠标悬停在页面封面上并点击 更改封面，然后选择或上传图片。根据我们当前页面封面的显示方式，1990x480 像素是理想尺寸。

• 重新定位封面图片

  将鼠标悬停在页面封面上并打开 操作菜单 。点击 重新定位，然后按你需要拖动图片，并点击 保存.

• 移除封面图片 将鼠标悬停在页面封面上并打开 操作菜单 ，然后点击 移除.

• 全宽和英雄宽度 你可以将页面封面的样式更改为横跨整个屏幕宽度，或仅覆盖内容宽度。将鼠标悬停在页面封面上并打开 操作菜单 ，然后从菜单中选择你偏好的选项。