内联内容

使用内联面板添加图片、链接、数学与 TeX 等

向您的内容添加内联元素。

内联面板可让您在不离开键盘的情况下快速向文本块添加额外内容。只需按下 / 在任何文本块上即可打开内联面板。斜杠将被您选择插入的内容替换。

注释

使用注释，您可以在不打断读者思路的情况下为文字添加额外的上下文。您可以用它们来解释单词的含义、插入额外信息等。读者可以将鼠标悬停在带有注释的文本上以在文本上方显示注释。

创建注释

要创建注释，请选择您想要注释的文本并单击 注释 上下文菜单中的选项。撰写完注释后，单击注释外部即可继续在文本块中写作。

Markdown 表示法

您可以将内容写成 Markdown 脚注 以将它们作为注释添加到 GitBook 中。脚注指示符应紧跟在您要注释的单词之后；不应出现在标点符号或其他符号之后。

这是一个简单的脚注[^1]，这是一个更长的脚注[^bignote]。

[^1]: 这是第一个脚注。

[^bignote]: 这是一个包含多段文字和代码的脚注。

    缩进段落以将它们包含在脚注中。

    `{ my code }`

    随意添加任意多的段落。

图片

内联图片会与页面上的文本并列显示。

默认情况下，图片设置为原始大小，最大宽度为 300px。您可以单击图片以打开格式面板然后选择三种选项之一来更改大小：

1. 内联大小： 图像按比例与字体大小匹配——非常适合图标和徽章。

2. 原始大小： 图像将保持内联并以原始大小显示，最大宽度为 300 像素。

3. 转换为块： 此操作会将内联图像转换为 图像块，其宽度与您的内容一样宽。

图像块 提供更多选项，包括更多尺寸和添加说明的功能——但不会与您的文本内联显示。

在 Markdown 中的表示

这是一个内联图片： <img src=".gitbook/assets/GitBook - Dark.jpg" alt="Dark version of GitBook logo" data-size="line">

表情符号

您可以通过按下 / 来打开内联面板以添加表情符号。或者，输入 : ，一列表情符号会直接在行内弹出——您可以开始输入表情名称以缩小选择范围。

在 Markdown 中的表示

:house:
:car:
:dog:

链接

您可以插入三种不同类型的链接：

• 相对链接

• 绝对链接

• 电子邮件地址 mailto 链接

相对链接

相对链接是通过链接到已存在于您的空间中的 页面 创建的。使用相对链接的优点是如果页面的 URL、名称或位置发生变化，其引用将保持最新——因此最终会有更少的断链。

以下是插入相对链接的方法：

1. 在段落中想插入链接的位置单击，或选择一些文本。

2. 按 / 打开内联面板并选择 链接，单击上下文菜单中的 链接 按钮，或按下 ⌘ + K.

3. 开始输入您要链接的页面标题。

4. 从下拉搜索结果中选择该页面。

5. 按下 回车.

绝对链接

绝对链接是您可以复制并粘贴到内容中的外部链接。当您想链接到文档外的内容时，它们非常有用。

插入绝对链接的方法：

1. 在段落中想插入链接的位置单击，或选择一些文本。

2. 按 / 打开内联面板并选择 链接，单击上下文菜单中的 链接 按钮，或按下 ⌘ + K.

3. 粘贴您想链接的 URL。

4. 按下 回车.

为什么外部链接不在新标签页打开？

当您在文档中添加指向外部网站的链接时，它将在相同标签页中打开。

GitBook 遵循此 W3C 推荐的行为 以支持 可访问性 并为您的读者提供一致且包容的体验。

电子邮件地址 mailto 链接

电子邮件地址 mailto 当您希望访客单击链接以打开其默认电子邮件客户端并填充 至 字段为链接的电子邮件地址，以便他们可以编写并发送电子邮件时，mailto 链接很有用。

以下是插入电子邮件地址 mailto 链接：

1. 在段落中想插入链接的位置单击，或选择一些文本。

2. 按 / 打开内联面板并选择 链接，单击上下文菜单中的 链接 按钮，或按下 ⌘ + K.

3. 粘贴或输入 mailto:[e-mail], 替换 [e-mail] 为您想使用的电子邮件地址。

4. 按下 回车.

在 Markdown 中的表示

[这是指向此空间中另一个页面的相对链接](../content-structure/page.md)
[这是一个绝对链接](https://www.gitbook.com/blog)
[这是一个链接](mailto:[e-mail]) 到我们的支持邮箱地址

数学与 TeX

使用此选项，您可以在内容中创建内联数学公式，如下所示： $f(x) = x * e^{2 pi i \xi x}$。我们使用 KaTeX 库来渲染公式。

您也可以插入 块级数学公式 方法是在空白块中打开命令面板并选择第二个 数学与 TeX 选项。

在 Markdown 中的表示

# Math and TeX block

$$f(x) = x * e^{2 pi i \xi x}$$

按钮

按钮是突出行动号召或向文档添加搜索或 Ask AI 栏的好方法。您可以使用它们将读者发送到某处，或帮助他们找到答案。

按钮操作

按钮不仅可以链接到 URL。您还可以直接在页面上将按钮变成搜索或 GitBook Assistant 的提问栏。这些操作也适用于已发布的页面——正如下面的示例所示，

您可以配置以下操作：

添加链接按钮

将读者发送到另一个页面或外部 URL：了解有关 Assistant 的更多信息

添加搜索栏

打开搜索并可选择预设查询：

添加 Ask AI/GitBook Assistant 提问栏

打开 GitBook Assistant 并可选择预设提示：

添加禁用按钮

显示一个故意处于非活动状态的按钮：

创建并配置按钮

1. 键入 / 并选择 按钮.

2. 单击按钮以打开 标签 菜单。

3. 选择一个操作，然后设置标签和样式。

4. 可选：添加预设的搜索查询或 Assistant 提示。

样式

链接和非活动按钮都有主样式和次样式。以下是几个示例：

注册 GitBook 回到顶部

在 Markdown 中的表示

<a href="https://app.gitbook.com" class="button primary">GitBook</a>

图标

图标允许您为站点添加额外的视觉提示。您可以将它们内联添加到段落中、放在卡片内或放在任何需要装饰的地方。它们将使用您在 自定义设置.

中定义的视觉样式。 访问 Font Awesome

在 Markdown 中的表示

以浏览可用的不同图标。

<i class="fa-github">:github:</i>

表达式 表达式允许您动态显示在变量 / 中定义的内容。表达式可以从 菜单中插入。插入后，单击该表达式即可调出表达式编辑器，允许您引用并 有条件地格式化