必须用HTML video标签或平台特有机制(如B站链接语法、iframe、GIF)实现视频显示,纯Markdown不支持;推荐MP4+H.264格式,注意路径、编码与兼容性限制。

要在网页中正确显示视频,必须让Markdown解析器能识别并渲染HTML多媒体标签,纯Markdown语法本身不支持视频插入,所有有效方案都依赖HTML能力或平台特有机制。
原生HTML video标签嵌入(通用方案)
这是最标准、兼容性最强的方法,适用于Typora、Obsidian、VS Code(导出HTML后)、GitHub Pages等支持HTML的环境。
第一步:在Markdown文件中直接写入
第二步:确保src指向的是可公开访问的URL——【本地相对路径如./video.mp4在VS Code预览中必然失效】,因为编辑器沙箱禁止读取本地文件系统。
第三步:推荐使用MP4格式+H.264编码,避免用AV1或HEVC,否则部分旧版浏览器会静音或黑屏;width和height建议固定值,防止页面重排。
B站视频一键嵌入(CSDN/博客园等平台专用)
如果你在CSDN、博客园等支持B站自动识别的平台写文档,根本不用写HTML代码。
方法一:直接粘贴B站视频链接作为图片语法

方法二:指定尺寸(加空格+等号+宽x高)

注意:该功能仅在已启用B站解析的平台生效,GitHub或纯静态站点不识别此语法,会显示为损坏图片。
iframe嵌入第三方视频(跨平台保底方案)
当目标平台禁用
复制视频分享页的“嵌入代码”,提取其中src地址,例如B站iframe的src形如://player.bilibili.com/player.html?isOutside=true&bvid=BV1K5Mjz4EcP&p=1&autoplay=0
然后写成标准iframe结构:
这一步操作起来很简单,直接把提取出的src填进iframe里就行。但要注意:某些平台(如CSDN)会自动过滤iframe的allowfullscreen属性,导致全屏按钮消失,此时需改用平台提供的视频插入按钮补救。
本地视频转GIF再插入(轻量替代方案)
如果只是想展示几秒关键操作,且对画质和时长要求不高,这是最省事的方案。
用FFmpeg或在线工具将MP4截取并转为GIF,控制体积在2MB以内。
然后像插入普通图片一样写:
这一步不需要任何HTML知识,也不受编辑器限制,所有Markdown环境都支持,但【超过5秒或带文字的GIF易模糊,慎用于技术演示】。


















