---
title: "图片与视频"
description: "用 Markdown 图片语法插入远程或本地图片，用 `u-color-mode-image` 为亮色与暗色模式分别提供截图，用 `:video` 嵌入视频；本页同时说明图片放置位置与替代文本的写法。"
canonical_url: "https://docs.mhaibaraai.cn/docs/writing/media"
---
# 图片与视频

> 用 Markdown 图片语法插入远程或本地图片，用 `u-color-mode-image` 为亮色与暗色模式分别提供截图，用 `:video` 嵌入视频；本页同时说明图片放置位置与替代文本的写法。

## 图片

### 远程图片

```mdc
![Nuxt 社交图片](https://nuxt.com/new-social.jpg)
```

### 本地图片

本地图片放在站点的 `public/` 目录，以 `/` 开头引用：

```mdc
![夕阳下云海中的雪山](/mountains.webp)
```

> [!NOTE]
> See: https://image.nuxt.com/
> 
> Markdown 图片由 
> 
> <NuxtImg>
> 
>  渲染，优化方式由项目的 
> 
> image.provider
> 
>  决定。本站在 Cloudflare Workers 上使用 
> 
> none
> 
>  provider，直接使用原图 URL。

方括号中的替代文本描述图片内容，供屏幕阅读器与搜索引擎读取。不要写「图片」「截图」这类没有信息量的词。

## 亮色与暗色截图

界面截图在亮色与暗色模式下差异明显时，用 `u-color-mode-image` 分别提供两张图，页面按当前主题显示对应的一张：

```mdc
:u-color-mode-image{light="/assets/templates/movk-nuxt-light.png" dark="/assets/templates/movk-nuxt-dark.png" alt="@movk/nuxt 文档站首页" class="rounded-md border border-default"}
```

> [!TIP]
> 
> 两张图保持相同尺寸，切换主题时页面不会跳动。

## 视频

`:video` 渲染原生 `<video>` 元素，属性与 HTML 一致：

```mdc
:video{autoplay controls loop muted src="https://media.w3.org/2010/05/sintel/trailer.mp4"}
```

浏览器只允许静音视频自动播放，使用 `autoplay` 时同时加上 `muted`。


## Sitemap

See the full [sitemap](https://docs.mhaibaraai.cn/sitemap.md) for all pages.
