在Markdown中插入Video

  Markdown 是一种轻量级标记语言,广泛用于撰写文档、博客、项目 README 等。它以简洁的语法著称,但在嵌入视频这类富媒体内容时却没有原生语法支持。不过,借助 HTML 的能力,我们可以轻松地在 Markdown 文件中嵌入视频,实现展示和播放功能。本文将通过一个简单的示例,讲解如何在 Markdown 中插入视频标签,并说明各属性的作用与使用建议。

基础写法

虽然标准 Markdown 语法不支持 <video>,但大多数 Markdown 渲染器(如 GitHub Pages、Hexo、VuePress、VitePress、Typora 等)都支持内嵌 HTML 标签。因此我们可以直接插入以下代码:

1
2
3
4
<video controls width="600">
<source src="https://www.w3schools.com/html/movie.mp4" type="video/mp4">
您的浏览器不支持 video 标签。
</video>

实际渲染效果如下(支持 HTML 渲染的平台上可播放):

属性说明

属性 说明
controls 显示浏览器默认的视频控制按钮
width 视频播放器的宽度(单位为像素)
height 可选,设置播放器高度
autoplay 自动播放(注意:现代浏览器对自动播放有音频限制)
loop 播放完自动重新开始播放
muted 静音播放,常与 autoplay 一起使用
poster 视频封面图,未播放时显示的图片 URL

兼容性建议

为了兼容不同浏览器,建议提供多种视频格式:

1
2
3
4
5
6
<video controls>
<source src="video.mp4" type="video/mp4">
<source src="video.ogg" type="video/ogg">
<source src="video.webm" type="video/webm">
您的浏览器不支持 video 标签。
</video>

这样做可以保证在老旧浏览器中尽可能播放成功。

注意事项

  • 自托管 vs 外链:若使用本地视频文件,应确保部署时视频路径正确;若使用外链视频,需注意带宽与版权问题。
  • 响应式设计:建议配合 CSS 控制视频大小,如设置 max-width: 100% 以适配不同屏幕。
  • Markdown 渲染限制:部分平台(如某些静态博客引擎)默认禁用 HTML,请根据文档开启。
作者

Fu9Zhou

发布于

2025-06-05

许可协议