图片

向页面添加图片或图片画廊,为暗色模式添加图片变体,并根据需要调整大小和对齐方式

您可以将图像插入页面,然后选择其大小以及将其对齐到左侧、居中或右侧。您还可以在图像块上可选地添加替代文本和/或标题。

提示: 出于无障碍考虑,我们建议为图像设置替代文本。

图像块示例

A photograph taken from space looking back towards Earth. A satellite is in the foreground, and in the background is an ocean-covered part of our planet with patchy clouds.
带标题的图像块示例

上传图像

有两种方法可以将图像添加到内容中:

  1. 将图像从您的文件管理系统拖放到页面上的空块中。

  2. 向页面添加图像块 并使用 选择图像 出现在窗口右侧的侧边面板。

如果您遵循第二种流程,您可以选择上传文件、选择先前上传的文件、粘贴图像 URL 或从 Unsplash 通过内置搜索添加图像。

创建图像画廊

向图像块添加多个图像将创建画廊。为此,请打开块的 选项菜单 The Options menu icon in GitBook 并选择 添加图像… 以打开 选择图像 侧边面板。

要从画廊中删除图像,请打开 编辑菜单 在要删除的图像上并按下 删除 ⌫ 键。

为亮/暗模式添加图像

您可以为已发布站点的亮色和暗色模式设置不同的图像。GitBook 会根据访问者所处的模式自动显示正确的图像。

要为暗色模式添加图像,请将鼠标悬停在图像上,打开 编辑菜单 然后点击 替换图像 The Replace image icon in GitBook.

在下拉菜单中,选择 为暗色模式添加图像。设置后,您可以从同一菜单替换任一图像。

通过 GitHub/GitLab 同步的亮/暗模式图像

您还可以通过 HTML 语法在 Markdown 中添加亮/暗模式图像(<picture><source>).

对于块图像,请在 <figure> HTML 元素中使用一个 <picture><source>

对于内嵌图像(与文本同一行的图像),请使用 <picture> HTML 元素中使用一个 <source>

调整大小

要调整图像大小,请将鼠标悬停其上并打开 编辑菜单 。点击 大小 按钮从可用选项中更改图像的大小。

A GitBook screenshot showing how to resize an image
调整图像大小
  • – 图像大小的 25%

  • 中等 – 图像大小的 50%

  • – 图像大小的 75%

  • 适应 – 删除所有大小规格并以原始大小显示,或对于较大图像限定最大宽度为 735 像素 的宽度。

如果您的图像比编辑器更宽,GitBook 会将图像宽度限制为编辑器宽度,且调整大小将基于此限制。

注意: 在图像画廊中调整图像大小时,结果可能与单独调整图像时不同。

您可以使图像块 跨越窗口的全宽 方法是点击块旁边的 选项菜单 The Options menu icon in GitBook 并选择 全宽.

通过 Git 同步调整图像大小

如果您希望更精确地控制图像大小,可以在 GitHub 或 GitLab 的 Markdown 中使用 Markdown 指定确切尺寸。

当我们导出图像时,我们使用 HTML 标签 <img/>。根据规范,我们可以使用 widthheight 属性来指定图像尺寸,这些属性只接受像素值或数字与 % 符号组合。 指定图像尺寸的有效变体包括: <img width="100" /> 将图像设置为 100 像素宽 <img width="100%" /> 将图像设置为全幅(尽管这会受到编辑器的限制)

对齐图像

默认情况下,图像块将以其原始大小居中显示图像。

要更改图像的对齐方式,请打开块的 选项菜单 The Options menu icon in GitBook 并选择所需的对齐方式。此操作仅影响比编辑器窄的图像,或您已对其进行 调整大小.

为图像加框

您可以为图像块添加框架,以使图像具有一致的外观并在视觉上将其与周围内容分隔开。

A black and white photograph of a lone figure walking across a stark white landscape
带框图像可以有标题,并在标题后显示微妙的网格背景。

要为图像添加框架,请将鼠标悬停在图像上,打开块的 选项菜单 并启用 带框 切换开关。

须知: 您只能为块中的单张图像添加框架。包含多张图像的图像块和内嵌图像不能添加框架。

在 Markdown 中的表示

最后更新于

这有帮助吗?