markdown-embed-video

Markdown 嵌入视频链接

补充说明

Markdown 是一款纯文本轻量级标记语言，语法简洁、易读易写，可直接渲染为 HTML。广泛用于项目 README、技术文档、个人博客、云笔记、静态站点等场景。

注意：部分纯标准 Markdown 平台（如部分简易编辑器）不支持内嵌 HTML 标签，视频嵌入功能会失效，该用法仅适用于兼容 HTML 的 Markdown 环境。

一、嵌入本地 / 在线普通视频

使用原生 HTML \<video\> 标签实现，支持播放控件、自定义宽高，语法如下：

<video src="视频地址" controls="controls" width="宽度" height="高度"></video>

示例代码

<video src="https://blog.mobufan.eu.org:666/video/和风天气时钟插件安装.mp4" controls="controls" width="650" height="300"></video>

• controls：显示播放、暂停、进度条等原生控件，必填

• width/height：自定义视频宽高，可按需修改数值

二、嵌入 Bilibili 视频（iframe 方案）

Bilibili 官方提供 iframe 嵌入代码，在此基础上可自定义画质、弹幕、自动播放、页面权限、尺寸，兼顾体验与安全性。

1. 获取官方嵌入代码

1. 打开目标 Bilibili 视频页，点击分享按钮

2. 选择「嵌入代码」，系统自动复制原生 iframe 代码

3. 原生代码示例：

<iframe src="//player.bilibili.com/player.html?isOutside=true&aid=327623069&bvid=BV1JA411h7Gw&cid=171385214&p=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>

2. 分步优化参数

将代码分为视频源链接和iframe 属性两部分分别修改，逻辑更清晰。

2.1 优化视频链接参数

在 src 属性的链接末尾追加配置参数，无空格直接拼接：

&high_quality=1&danmaku=0&autoplay=0

参数释义：

• high\_quality=1：默认最高画质（0 为最低画质）

• danmaku=0：关闭弹幕（1 为开启弹幕）

• autoplay=0：关闭自动播放（1 为开启自动播放，多数浏览器限制自动播放）

修改后链接部分：

src="//player.bilibili.com/player.html?isOutside=true&aid=327623069&bvid=BV1JA411h7Gw&cid=171385214&p=1&high_quality=1&danmaku=0&autoplay=0"

2.2 优化 iframe 全局属性

在 allowfullscreen=\&\#34;true\&\#34; 后方添加空格，追加安全沙箱、宽高配置：

sandbox="allow-top-navigation allow-same-origin allow-forms allow-scripts" width="100%" height="446"

参数释义：

• allowfullscreen=\&\#34;true\&\#34;：允许视频全屏播放

• sandbox：安全沙箱限制，禁止恶意弹窗、跨站风险，提升页面安全性

• width=\&\#34;100%\&\#34;：宽度自适应容器，也可填写固定像素（如 800px）

• height=\&\#34;446\&\#34;：固定视频高度，根据排版按需调整

修改后属性部分：

scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" sandbox="allow-top-navigation allow-same-origin allow-forms allow-scripts" width="100%" height="446"></iframe>

3. 合并最终完整代码

两部分中间用单个空格连接，得到可直接使用的完整嵌入代码：

<iframe src="//player.bilibili.com/player.html?isOutside=true&aid=327623069&bvid=BV1JA411h7Gw&cid=171385214&p=1&high_quality=1&danmaku=0&autoplay=0" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" sandbox="allow-top-navigation allow-same-origin allow-forms allow-scripts" width="100%" height="446"></iframe>

三、完整使用示例

彩色文字仅为演示样式，同样依赖 HTML 支持，可按需保留 / 删除

Markdown 嵌入 Bilibili 视频 效果演示：

四、常见问题补充

1. 视频无法播放

   • 检查平台是否禁止 HTML 标签；

   • 网络环境限制、B 站跨域访问拦截也会导致加载失败。

2. 自动播放不生效 现代浏览器出于体验与流量限制，默认拦截视频自动播放，建议保持 autoplay=0。

3. 排版溢出 将 width 设为 100% 实现自适应，适配手机、电脑等不同设备。

4. 安全提示 建议保留 sandbox 沙箱属性，规避嵌入第三方 iframe 带来的网页安全风险。