GitHub README 中嵌入视频的方法指南 🎥

本文整理并总结了如何在 GitHub README.md 文件中插入视频显示的几种方案，并附详细代码示例，适用于展示项目演示或教程时使用。

方法一：使用 GitHub 拖拽上传 MP4 视频文件

Github 自带功能：在 README.md 编辑页面拖拽 .mp4 文件，上传后会生成一个类似 https://github.com/.../assets/... 的 URL，GitHub 会自动渲染该视频并带音频控制(stackoverflow.com)。

<video src="https://github.com/你的仓库/assets/唯一ID" controls autoplay muted loop></video>

使用此方式的视频自动嵌入，能保留音频，并直接在 README 中播放。但请注意文件大小上限（约 10MB）。

由于 Markdown/HTML 限制，直接插入 YouTube iFrame 在 README 中无法生效，但可通过链接图像实现类似效果：

[![视频标题](https://img.youtube.com/vi/VIDEO_ID/0.jpg)](https://www.youtube.com/watch?v=VIDEO_ID)

点击缩略图后用户跳转至 YouTube 播放页面。你也可以使用其他尺寸的缩略图，如 hqdefault.jpg 或 maxresdefault.jpg(ardalis.com)。

将演示录制为 GIF 文件效果不错，GitHub 支持直接渲染 GIF：

![演示](./assets/demo.gif)

尽管 GIF 无音频，但体积通常比 MP4 更小，且兼容性更好(stackoverflow.com)。

对于上传后的附件链接，可以直接用 HTML <video>：

<video src="https://github.com/.../assets/ID.mp4" width="500" controls></video>

注意，该方式只能运行在 GitHub 生成的“附件 URL”上，不支持 raw.githubusercontent.com 的链接(github.com)。

推荐做法：

为何 iframe 嵌入 YouTube 在 README 不行？ GitHub 禁用 iframe，因此无法直接播放 YouTube 视频，只能通过图像跳转。
视频附件链接与 raw 链接有什么区别？ GitHub 只自动渲染附件上传生成的 URL，不支持 raw.githubusercontent.com 链接(github.com)。

可根据视频用途与项目需求灵活选择以上方案 ── README 效果将更丰富生动！