图片

添加图片

通过主工具栏的图片按钮，或 / 菜单中的图片项，选择媒体库中已就绪的图片，也可以直接上传。选中图片后，可以使用其编辑控件，并修改描述图片内容的替代文字。

可视化编辑

选择图片编辑替代文本，再切换到源码查看保存的路径。

images.md

Generic

可视化源码

重置示例

正在加载编辑器…

这是一个可编辑的示例，修改仅保留在当前页面。

![Starlight 文档页面](/images/screenshots/templates/starlight-docs.jpg)

这里的路径只是示例，请替换成网站中实际存在的文件路径，或已上传图片的 URL。

仓库中的图片

相对路径从内容文件的位置解析，根路径使用内容空间的公开目录。已有仓库图片在可视化编辑后仍保留 Markdown 路径。

上传的图片

在图片选择器中，选择 Public 可使用仓库图片，选择媒体库则使用托管图片。Public 上传会在发布后写入仓库；媒体库上传提供公开链接，文件独立于 Git 保存。替代文字应说明图片的用途，操作截图尤其需要描述清楚。需要让所有读者看到的解释，可以写在图注中。

保存方式见媒体指南，其他媒体格式见音频与视频。