内联内容

使用内联调色板添加图像、链接、数学与 TeX 等

A GitBook screenshot showing inline content options
向内容添加内联元素。

内联调色板可让您快速向文本块中添加额外内容,而无需将手从键盘上移开。只需在任何文本块上按下 / 以打开内联调色板。斜杠将被您选择插入的内容替换。

注释

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

创建注释

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

Markdown 表示法

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

图片

内联图片将在页面上与文本并列显示。

默认情况下,图片设置为其原始大小,最大宽度为 300px。您可以通过点击图片以打开格式化调色板,然后选择三种选项之一来更改大小:

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

  2. 原始大小: 图片将以其原始大小保持内联显示,最大宽度为 300 像素。

  3. 转换为块: 这会将内联图片转换为 图片块,其宽度与您的内容一样宽。

circle-info

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

在 Markdown 中的表示

表情符号

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

在 Markdown 中的表示

链接

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

相对链接

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

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

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

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

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

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

  5. 按下 Enter.

绝对链接

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

要插入绝对链接:

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

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

  3. 粘贴您要链接的 URL。

  4. 按下 Enter.

circle-info

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

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

GitBook 遵循这一 W3C 推荐的行为arrow-up-right 以支持 无障碍arrow-up-right 并为读者确保一致且包容的体验。

电子邮件地址 mailto 链接

电子邮件地址 mailto 链接在您希望访客点击一个链接以打开其默认邮件客户端并填写 字段中包含链接的电子邮件地址时非常有用,以便他们可以编写并发送电子邮件。

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

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

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

  3. 粘贴或输入 mailto:something@address.com,将 something@address.com 替换为您想要使用的电子邮件地址。

  4. 按下 Enter.

在 Markdown 中的表示

数学与 TeX

使用此选项,您可以在内容中创建内联数学公式,如下所示: f(x)=xe2piiξxf(x) = x * e^{2 pi i \xi x}。我们使用 KaTeXarrow-up-right 库来渲染公式。

circle-info

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

在 Markdown 中的表示

按钮

按钮是描述号召性用语的好方法。您可以使用它们将用户引导到 GitBook 中的其他页面,或外部 URL。

按钮具有主要样式和次要样式。下面是几个示例:

注册 GitBook 返回顶部

在 Markdown 中的表示

图标

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

facebook github x-twitter instagram

中定义的视觉样式。 访问arrow-up-right Font Awesome

在 Markdown 中的表示

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

表达式 表达式允许您动态显示在变量 / 中定义的内容。表达式可以从 菜单中插入。插入后,点击该表达式将调出表达式编辑器,允许您引用并arrow-up-right 有条件地格式化(conditional format)您的变量。

最后更新于

这有帮助吗?