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


本地图片
本地图片放在站点的 public/ 目录,以 / 开头引用:


Markdown 图片由
<NuxtImg> 渲染,优化方式由项目的 image.provider 决定。本站在 Cloudflare Workers 上使用 none provider,直接使用原图 URL。方括号中的替代文本描述图片内容,供屏幕阅读器与搜索引擎读取。不要写「图片」「截图」这类没有信息量的词。
亮色与暗色截图
界面截图在亮色与暗色模式下差异明显时,用 u-color-mode-image 分别提供两张图,页面按当前主题显示对应的一张:


: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"}
两张图保持相同尺寸,切换主题时页面不会跳动。
视频
:video 渲染原生 <video> 元素,属性与 HTML 一致:
:video{autoplay controls loop muted src="https://media.w3.org/2010/05/sintel/trailer.mp4"}
浏览器只允许静音视频自动播放,使用 autoplay 时同时加上 muted。