在文章里使用图片和媒体

日常文章里的少量图片，最适合直接随博客一起保存。这样文章和图片在同一个仓库中，备份、迁移和版本管理都很直接。

普通图片

把压缩后的图片放进 public/images，然后在文章中引用：

![图片的文字说明](/images/example.webp)

推荐优先使用 WebP 或 AVIF，并在上传前控制尺寸。大多数正文图片宽度不必超过 1600 像素。

需要图注时，可以在 MDX 中使用 HTML：

<figure>
  <img src="/images/example.webp" alt="清晰描述图片内容" />
  <figcaption>图片说明</figcaption>
</figure>

大文件与网页上传

如果以后需要上传大量图片、音频或附件，可以单独建立一个 Cloudflare R2 存储桶，并通过自定义域名访问。文章中只需要保存最终文件 URL。

网页上传入口不应该直接暴露 R2 密钥。更安全的方式是使用独立 Worker 完成身份验证，并签发短期上传地址。这样媒体系统和静态博客仍然彼此隔离。

视频需要自动转码和多清晰度播放时，可以再接入 Cloudflare Stream；普通短视频原文件则可以存进 R2。