行内内容

使用行内面板添加图片、链接、公式与 TeX 等内容

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

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

注释

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

创建注释

要创建注释，请选择您想要注释的文本，然后点击 注释 菜单中的选项。写完注释后，点击其外部即可继续在文本块中输入。

Markdown 表示法

您可以将内容写为 Markdown 脚注 ，以便在 GitBook 中将它们添加为注释。脚注标记应紧跟在您希望注释的词语后面；它们不应出现在标点符号或其他符号之后。

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

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

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

    缩进段落可将其包含到脚注中。

    `{ my code }`

    您可以添加任意多个段落。

图片

行内图片会与页面上的文本并排显示。

默认情况下，图片会以原始大小显示，最大宽度为 300px。您可以通过点击图片打开格式调色板，然后从以下三个选项中选择一个来更改大小：

1. 行内大小： 图片会按比例适配字体大小——非常适合图标和徽章。

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

3. 转换为块级： 这会将行内图片转换为 图片块，其宽度与您的内容相同。

图片块 提供更多选项，包括更多尺寸以及添加标题的能力——但不会与您的文本并排显示。

Markdown 中的表示

这是一个行内图片：<img src=".gitbook/assets/GitBook - Dark.jpg" alt="GitBook 深色版本徽标" data-size="line">

表情符号

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

Markdown 中的表示

:house:
:car:
:dog:

链接

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

• 相对链接

• 绝对链接

• 电子邮件地址 mailto 链接

相对链接

相对链接是通过链接到 页面 中已存在的内容而创建的链接。使用相对链接的好处是，如果页面的 URL、名称或位置发生变化，其引用会保持最新——因此您最终会减少失效链接。

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

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

2. 按 / 打开行内调色板并选择“链接”，点击 链接 按钮，或按 ⌘ + K.

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

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

5. 按 Enter.

绝对链接

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

要插入绝对链接：

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

2. 按 / 打开行内调色板并选择“链接”，点击 链接 按钮，或按 ⌘ + K.

3. 粘贴您要链接的 URL。

4. 按 Enter.

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

当您在文档中添加外部网站链接时，它会在同一标签页中打开。

GitBook 遵循这一 W3C 建议的行为 ，以支持 可访问性 并确保为您的读者提供一致且包容的体验。

电子邮件地址 mailto 链接

电子邮件地址 mailto 链接在您希望访客点击某个链接后打开其默认邮件客户端并填写 收件人 字段中的电子邮件地址时非常有用，这样他们就可以撰写邮件发送。

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

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

2. 按 / 打开行内调色板并选择“链接”，点击 链接 按钮，或按 ⌘ + K.

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

4. 按 Enter.

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 中的表示

# 数学与 TeX 块

$$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>

表达式 表达式可让您动态显示在变量 / 中定义的内容。表达式可从 菜单中插入。插入后，点击表达式将打开表达式编辑器，使您能够引用并 有条件地格式化您的变量。