# 图片

选择图片，使用仓库路径或已上传媒体的 URL。

import ContentEditor from '@/components/editor/ContentEditor.astro';

## 添加图片

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

## 可视化编辑

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

<ContentEditor content="images" />

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

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

## 仓库中的图片

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

## 上传的图片

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

保存方式见[媒体指南](/docs/zh-cn/media/)，其他媒体格式见[音频与视频](/docs/zh-cn/editor/markdown/audio-video/)。