# 行内内容

<figure><img src="/files/fc1a344771a3d7328e23ce32860fc163a847b65f" alt="A GitBook screenshot showing inline content options"><figcaption><p>向您的内容添加行内元素。</p></figcaption></figure>

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

## 注释

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

### 创建注释

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

### Markdown 表示法

您可以将内容写为 [Markdown 脚注](https://www.markdownguide.org/extended-syntax/#footnotes) ，以便在 GitBook 中将它们添加为注释。脚注标记应紧跟在您希望注释的词语后面；它们不应出现在标点符号或其他符号之后。

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

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

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

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

    `{ my code }`

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

## 图片

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

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

1. **行内大小：** 图片会按比例适配字体大小——非常适合图标和徽章。
2. **原始大小：** 图片将保持行内显示并保持原始大小，最大宽度为 300 像素。
3. **转换为块级：** 这会将行内图片转换为 [图片块](/docs/documentation/zh/creating-content/blocks/insert-images.md)，其宽度与您的内容相同。

{% hint style="info" %}
[图片块](/docs/documentation/zh/creating-content/blocks/insert-images.md) 提供更多选项，包括更多尺寸以及添加标题的能力——但不会与您的文本并排显示。
{% endhint %}

### Markdown 中的表示

{% code overflow="wrap" %}

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

{% endcode %}

## 表情符号

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

### Markdown 中的表示

{% code overflow="wrap" %}

```markdown
:house:
:car:
:dog:
```

{% endcode %}

## 链接

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

* [相对链接](#relative-links)
* [绝对链接](#absolute-links)
* [电子邮件地址 `mailto` 链接](#email-address-mailto-links)

### 相对链接

相对链接是通过链接到 [页面](/docs/documentation/zh/creating-content/content-structure/page.md) 中已存在的内容而创建的链接。使用相对链接的好处是，如果页面的 URL、名称或位置发生变化，其引用会保持最新——因此您最终会减少失效链接。

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

1. 在段落中点击您想插入链接的位置，或选中一些文本。
2. 按 / 打开行内调色板并选择“链接”，点击 **链接** 按钮，或按 **⌘ + K**.
3. 开始输入您要链接到的页面标题。
4. 从下拉搜索结果中选择该页面。
5. 按 `Enter`.

### 绝对链接

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

要插入绝对链接：

1. 在段落中点击您想插入链接的位置，或选中一些文本。
2. 按 / 打开行内调色板并选择“链接”，点击 **链接** 按钮，或按 **⌘ + K**.
3. 粘贴您要链接的 URL。
4. 按 `Enter`.

{% hint style="info" %}
**为什么外部链接不会在新标签页中打开？**

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

GitBook 遵循这一 [W3C 建议的行为](https://www.w3.org/TR/WCAG20-TECHS/G200.html) ，以支持 [可访问性](https://it.wisc.edu/learn/make-it-accessible/websites-and-web-applications/when-to-open-links-in-a-new-tab/) 并确保为您的读者提供一致且包容的体验。
{% endhint %}

### 电子邮件地址 mailto 链接

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

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

1. 在段落中点击您想插入链接的位置，或选中一些文本。
2. 按 / 打开行内调色板并选择“链接”，点击 **链接** 按钮，或按 **⌘ + K**.
3. 粘贴或输入 `mailto:something@address.com`，将 `something@address.com` 替换为您想使用的电子邮件地址。
4. 按 `Enter`.

### Markdown 中的表示

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

## 数学与 TeX

使用此选项，您可以在内容中创建行内数学公式，例如： $$f(x) = x \* e^{2 pi i \xi x}$$。我们使用 [KaTeX](https://katex.org/docs/supported.html) 库来渲染公式。

{% hint style="info" %}
您还可以通过 [插入一个块级数学公式](/docs/documentation/zh/creating-content/blocks/math-and-tex.md) ：在空白块中打开命令面板，并选择第二个“数学与 TeX”选项。
{% endhint %}

### Markdown 中的表示

```markdown
# 数学与 TeX 块

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

## 按钮

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

### 按钮操作

按钮不仅可以链接到 URL。您还可以将按钮变成搜索栏或 GitBook Assistant 提问栏——直接在页面上完成。这些操作在已发布的页面上也同样有效——正如您可以从下面的示例中看到的

您可以配置以下操作：

#### **添加链接按钮**

将读者发送到另一个页面或外部 URL：<a href="/pages/9f97be21402fc075995178c6e13cb838c64a90aa" class="button primary" data-icon="gitbook-assistant">了解更多关于 Assistant 的信息</a>

#### **添加搜索栏**

打开搜索，并可选预设查询： <button type="button" class="button primary" data-action="search" data-icon="magnifying-glass">搜索...</button>

#### **添加 Ask AI/GitBook Assistant 栏**

打开 [GitBook Assistant](/docs/documentation/zh/ai-yu-sou-suo/gitbook-ai-assistant.md) ，并可选预设提示： <button type="button" class="button primary" data-action="ask" data-icon="gitbook-assistant">提一个问题...</button>

#### **添加一个禁用按钮**

显示一个有意处于非活动状态的按钮：<a class="button primary">非活动按钮</a>

### 创建并配置按钮

1. 输入 `/` 并选择 **按钮**.
2. 点击按钮以打开 **标签** 菜单。
3. 选择一个操作，然后设置标签和样式。
4. 可选：添加预设搜索查询或 Assistant 提示。

### 样式

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

<a href="https://app.gitbook.com/join" class="button primary">注册 GitBook</a> <a href="#annotations" class="button secondary">返回顶部</a>

### Markdown 中的表示

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

## 图标

图标可为您的站点添加额外的视觉提示。您可以将它们作为行内元素添加到段落中、卡片内，或任何您需要增添特色的地方。它们将使用您在 [自定义设置](/docs/documentation/zh/docs-site/customization/icons-colors-and-themes.md).

<i class="fa-facebook">:facebook:</i> <i class="fa-github">:github:</i> <i class="fa-x-twitter">:x-twitter:</i> <i class="fa-instagram">:instagram:</i>

中定义的视觉样式。 [访问](https://fontawesome.com/) Font Awesome

### Markdown 中的表示

```markdown
以查看可用的不同图标。
```

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

表达式 [表达式可让您动态显示在](/docs/documentation/zh/creating-content/variables-and-expressions.md)变量 `/` 中定义的内容。表达式可从 [菜单中插入。插入后，点击表达式将打开表达式编辑器，使您能够引用并](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Conditional_operator) 有条件地格式化您的变量。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.com/docs/documentation/zh/creating-content/formatting/inline.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.