图片
向页面添加图片或图片库，为深色模式添加图片变体，并按需调整图片大小和对齐方式
你可以将图片插入页面，然后选择其大小以及左对齐、居中或右对齐。你还可以选择在图片块中包含替代文本和/或说明文字。
图片块示例
上传图片
向内容中添加图片有两种方式：
将图片从你的文件管理系统直接拖放到页面中的一个空白块中。
添加图片块 到你的页面中并使用 选择图片 右侧出现的侧边栏。
如果你采用第二种方式，可以选择上传文件、选择之前上传的文件、粘贴图片 URL，或从 Unsplash 并使用内置搜索。
GitBook 允许你上传单个文件最大 100MB 的图片。
某个部分中的资源总数没有固定限制，不过 GitBook 保留因滥用而封禁账户的权利。对于大于上传限制的文件，请将其存储在 Google Drive 或 Dropbox 等服务中，并从你的页面链接到它们。
动图 GIF 每个文件限制为 200 帧。大文件——包括 GIF——会减慢页面加载速度，因此尽量避免在可行时直接上传大文件。
创建图片画廊
在图片块中添加多于一张图片会创建一个画廊。要这样做，请打开该块的 选项菜单 
并选择 添加图片… 以重新打开 选择图片 侧边栏。
要从画廊中删除一张图片，请打开 编辑菜单 
在你想删除的图片上，然后按 删除 ⌫ 键。
为浅色和深色模式添加图片
你可以为已发布站点的浅色和深色模式版本设置不同的图片。GitBook 会根据访客所处的模式自动显示正确的图片。
要为深色模式添加图片，请将鼠标悬停在图片上，打开 编辑菜单 并点击 替换图片 
.
在下拉菜单中，选择 为深色模式添加图片。设置完成后，你可以从同一菜单中替换任一图片。
注意： GitBook 目前还不支持某些情况中的浅色和深色模式图片，包括页面封面或位于 卡片上.
通过 GitHub/GitLab 同步使用浅色和深色模式图片
你也可以在 Markdown 中通过 HTML 语法（添加浅色和深色模式图片<picture> 以及 <source>).
对于块级图片，请使用 <figure> HTML 元素， <picture> 以及 <source> 其中包含：
对于行内图片（与文本并排显示的图片），请使用 <picture> HTML 元素， <source> 其中包含：
注意： 我们目前还不支持 仅适用于 GitHub 的语法 通过 #gh-dark-mode-only 或 #gh-light-mode-only.
调整大小
要调整图片大小，请将鼠标悬停其上并打开 编辑菜单 。点击 大小 按钮，从可用选项中更改图片大小。
小 – 图片大小的 25%
中号 – 图片大小的 50%
大号 – 图片大小的 75%
适应 – 移除所有大小设置，并以全尺寸显示，或将其最大宽度限制为 735 像素 ，适用于较大的图片。
如果图片宽度超过编辑器，GitBook 会将图片宽度限制为编辑器宽度，调整大小也会基于此限制。
通过 Git Sync 调整图片大小
如果你想更精确地控制图片大小，可以在 GitHub 或 GitLab 中使用 Markdown 指定确切尺寸。
当我们导出图片时，会使用 HTML 标签 <img/>。根据规范，我们可以使用 width 以及 height 属性来指定图片尺寸，这些属性只接受像素值，或数字和百分号的组合。 % \n\n指定图片尺寸的有效写法有：
<img width="100" /> 将图片设置为 100 像素宽
<img width="100%" /> 将图片设置为全尺寸（不过会受编辑器限制）
对齐图片
默认情况下，图片块会以全尺寸居中显示你的图片。
要更改图片的对齐方式，请打开该块的 选项菜单 并选择你想要的对齐方式。这只会影响宽度小于编辑器的图片，或你已经 调整大小.
为图片添加边框
你可以为图片块添加边框，让图片具有一致的外观，并在视觉上将其与周围内容区分开来。
要为图片添加边框，请将鼠标悬停其上，打开该块的 选项菜单 并启用 带边框 开关。
Markdown 中的表示方式
为什么我的图片没有加载？
“无法加载图片”错误表示该图片已在其源处被更改或删除。如果你是通过 URL 嵌入图片而不是上传它，GitBook 会依赖该 URL——如果图片在源站移动或消失，它就会停止在你的页面上显示。
要解决此问题，请直接将图片上传到 GitBook，或在图片位置发生变化时更新 URL。该错误也可能在你将图片从一个部分复制到另一个部分时出现，因为每个部分都有自己的文件目录——请在新部分中重新上传该图片。
你可以在以下位置查看已上传到某个部分的所有文件： 资料库 标签页，旁边 页面 在目录顶部
最后更新于
这有帮助吗？