图片
向页面添加图片或图片画廊,为暗色模式添加图片变体,并根据需要调整大小和对齐方式
您可以将图像插入页面,然后选择其大小以及将其对齐到左侧、居中或右侧。您还可以在图像块上可选地添加替代文本和/或标题。
图像块示例
上传图像
有两种方法可以将图像添加到内容中:
将图像从您的文件管理系统拖放到页面上的空块中。
向页面添加图像块 并使用 选择图像 出现在窗口右侧的侧边面板。
如果您遵循第二种流程,您可以选择上传文件、选择先前上传的文件、粘贴图像 URL 或从 Unsplash 通过内置搜索添加图像。
GitBook 允许您上传每个文件最大 100MB 的图像。
创建图像画廊
向图像块添加多个图像将创建画廊。为此,请打开块的 选项菜单 并选择 添加图像… 以打开 选择图像 侧边面板。
要从画廊中删除图像,请打开 编辑菜单 在要删除的图像上并按下 删除 ⌫ 键。
为亮/暗模式添加图像
您可以为已发布站点的亮色和暗色模式设置不同的图像。GitBook 会根据访问者所处的模式自动显示正确的图像。
要为暗色模式添加图像,请将鼠标悬停在图像上,打开 编辑菜单 然后点击 替换图像
.
在下拉菜单中,选择 为暗色模式添加图像。设置后,您可以从同一菜单替换任一图像。
注意: GitBook 目前不支持某些情况下的亮/暗模式图像,包括页面封面或 卡片.
通过 GitHub/GitLab 同步的亮/暗模式图像
您还可以通过 HTML 语法在 Markdown 中添加亮/暗模式图像(<picture> 和 <source>).
对于块图像,请在 <figure> HTML 元素中使用一个 <picture> 和 <source> :
对于内嵌图像(与文本同一行的图像),请使用 <picture> HTML 元素中使用一个 <source> :
注意: 我们尚不支持 仅适用于 GitHub 的语法 通过 #gh-dark-mode-only 或 #gh-light-mode-only.
调整大小
要调整图像大小,请将鼠标悬停其上并打开 编辑菜单 。点击 大小 按钮从可用选项中更改图像的大小。

小 – 图像大小的 25%
中等 – 图像大小的 50%
大 – 图像大小的 75%
适应 – 删除所有大小规格并以原始大小显示,或对于较大图像限定最大宽度为 735 像素 的宽度。
如果您的图像比编辑器更宽,GitBook 会将图像宽度限制为编辑器宽度,且调整大小将基于此限制。
通过 Git 同步调整图像大小
如果您希望更精确地控制图像大小,可以在 GitHub 或 GitLab 的 Markdown 中使用 Markdown 指定确切尺寸。
当我们导出图像时,我们使用 HTML 标签 <img/>。根据规范,我们可以使用 width 和 height 属性来指定图像尺寸,这些属性只接受像素值或数字与 % 符号组合。
指定图像尺寸的有效变体包括:
<img width="100" /> 将图像设置为 100 像素宽
<img width="100%" /> 将图像设置为全幅(尽管这会受到编辑器的限制)
对齐图像
默认情况下,图像块将以其原始大小居中显示图像。
要更改图像的对齐方式,请打开块的 选项菜单 并选择所需的对齐方式。此操作仅影响比编辑器窄的图像,或您已对其进行 调整大小.
为图像加框
您可以为图像块添加框架,以使图像具有一致的外观并在视觉上将其与周围内容分隔开。

要为图像添加框架,请将鼠标悬停在图像上,打开块的 选项菜单 并启用 带框 切换开关。
在 Markdown 中的表示
最后更新于
这有帮助吗?