> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/formatting/inline.md).

# 行内内容

<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. **转换为块：** 这会将行内图片转换为图片块，其宽度与您的内容相同。

{% hint style="info" %}
图片块提供更多选项，包括更多尺寸以及添加说明文字的能力——但不会与文本行内显示。
{% 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)

### 相对链接

相对链接是指链接到您部分中已存在页面所创建的链接。使用相对链接的优势在于，如果页面的 URL、名称或位置发生变化，其引用会保持更新——因此您最终会遇到更少的失效链接。

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

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

### 绝对链接

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

要插入绝对链接：

1. 在段落中您想插入链接的位置单击，或选中文本。
2. 按 / 打开行内面板并选择“链接”，点击 **链接** 上下文菜单中的按钮，或按 **⌘ + K**.
3. 粘贴您要链接的 URL。
4. 按 `回车键`.

{% 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. 按 `回车键`.

### 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" %}
您也可以在空白块中打开命令面板并选择第二个“数学与 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，并可选预设提示： <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>
```

## 图标

图标可为您的站点添加额外的视觉提示。您可以将它们行内添加到段落中、卡片内，或任何需要增加点视觉效果的地方。它们会使用您自定义设置中定义的视觉样式。

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

访问 [Font Awesome](https://fontawesome.com/) 以浏览可用的不同图标。

### Markdown 中的表示

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

## 表达式

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/formatting/inline.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.