这是一个老帖子，但它帮助了我。非常直接-只需从finder mp4文件拖放到Github ReadMe(编辑版)直接。

https://www.geeksforgeeks.org/how-to-add-videos-on-readme-md-file-in-a-github-repository/?id=discuss

2021年5月更新:

视频上传现在普遍可用

现在支持视频上传的任何地方，你可以在GitHub中编写Markdown，包括从移动应用程序。 共享演示，显示复制步骤，以及关于问题、拉请求和讨论评论以及存储库Markdown文件(如READMEs)的更多内容。

正如Lauren Brose (GitHub问题产品经理)详细说明的那样，这可以帮助:

帮助维护者重现错误 为审查人员提供有关拉取请求的上下文 分享一个功能是如何形成的 从任何地方上传你的视频!(所有用户现在都可以从iOS和Android GitHub移动应用程序上传视频)

注意:正如Sancarn所评论的，webm(开放网络媒体项目)似乎不受直接支持。 尽管……正如Garrett LeSage所指出的:

如果你把扩展名从。webm改为。mov(或者只是在。webm后面加上。mov)， @GitHub就会接受视频，甚至内联显示。

Matthew Gregg补充道:

webm在iOS设备上播放吗?这可能就是它们软挡的原因。

---

正如Abhishek Singh在评论中和Nat Friedman在推特上指出的那样，更新于2021年2月:

现在你终于可以了!-将图像和视频(mp4, gif)放到GitHub上的Markdown文件编辑器上。 粘贴也行，如果你喜欢这种东西的话。 它曾在发行和公关方面工作过一段时间;这里的新功能是支持markdown文件。 GitHub企业服务器往往会落后http://github.com几个月，但它将在未来的版本中实现。

Kyle Daigle (GitHub特殊项目高级总监)补充道:

目前，该文件被存储为存储库之外的资产(有点像上传到图像中的图像)。 (上传到githubusercontent并存储在那里。然后在markdown中链接到上传的图像。) 该团队有兴趣探索将图像添加到回购中…你想要这样的东西吗?

Sven-Michael Stübe comments:

我通常会把图片添加到我的回购中。特别是如果你把你的博客作为一个带有自定义域名的github页面。 但我认为这个功能也会增加很多复杂性。手动添加图像并不是什么大麻烦。对于pr +评论，拖放是更重要的

凯尔的答案:

对于博客的情况(这让我们想到了图像上传到回购)，你是完全正确的。 不过，当将图像添加到README或其他回购内文档时(当您不想上传到回购时)，这种类型的拖放非常有用。

自最初的提议以来，这个功能已经有了很长的路要走……早在2012年(!)

---

2020年12月更新:见“视频上传公测”，嵌入视频(仅嵌入，不包含链接/参考)

---

2010:“Github调味Markdown”不支持任何页面的这种功能:

一个旧的支持线程“在markdown文件中嵌入YouTube视频”指出:

pages.github。爱娥，是的，其他地方，没有。

(注:详见“Github顶级项目页面”，Github。io是2013年4月以来用户和组织页面的新域。 GitHub发布的页面显示在这里)

这可能是一个像语法高亮显示一样的特性请求。

例如:“HTML5视频降价”(2010年8月):

是否有办法实现HTML5视频到README。减价文件? 目前还没有，但我们可能会在未来扩展您可以使用readme做的事情。 与此同时，你可以通过GitHub页面和我们的维基来实现这一点。

---

Benjamin Oakes在评论中证实(2012年5月):

我发送了一个支持请求。回复是不支持嵌入视频。

对于简单的动画，你可以使用gif动画。例如，我在这个README文件中使用了一个。

这是一个老帖子，但它帮助了我。非常直接-只需从finder mp4文件拖放到Github ReadMe(编辑版)直接。

https://www.geeksforgeeks.org/how-to-add-videos-on-readme-md-file-in-a-github-repository/?id=discuss

使用以下步骤对我有用(这些都是在我的mac上本地完成的-所以没有必要在在线工具上共享内容):

我使用Mac上的QuickTime Player对我的Android模拟器(手机)进行了屏幕录制，并将其保存在文件recording.mov中 然后从我的终端使用以下命令将。mov转换为。gif(需要安装ffmpeg, gifsicle) Ffmpeg -i录音。Mov -pix_fmt rgb24 -r 10 -f GIF - | gifsicle ——optimize=3——delay=3 > out.gif 然后，我可以轻松地将视频的gif文件(out.gif)添加到我的README中，文件大小不那么大。Md直接在github.com上

在ReadMe中添加视频文件的url。

Github现在支持视频，查看更多详细答案:https://stackoverflow.com/a/4279746/1092815

你可以在这里看到一个活生生的例子(见自述文的末尾): https://github.com/alelievr/Mixture/blob/0.4.0/README.md

Github页面

我强烈建议将视频放在一个用GitHub Pages创建的项目网站上，而不是像VonC的回答中描述的那样;它将比这些想法都要好得多。但如果你像我一样需要快速解决问题，这里有一些建议。

使用gif

看到aloisdg的答案，结果是很棒的，gif在github的自述me上渲染;)

使用视频播放器图片

你可以用图片欺骗用户，让他们以为视频在自述页面上。这听起来像一个广告技巧，它并不完美，但它有效，而且很有趣;)

例子:

[![Watch the video](https://i.imgur.com/vKb2F1B.png)](https://youtu.be/vt5fpE0bzSY)

结果:

使用youtube的预览图片

你也可以在视频中使用youtube生成的图片。

用于youtube网址的格式为:

https://www.youtube.com/watch?v=<VIDEO ID>
https://youtu.be/<VIDEO URL>

预览url的形式是:

https://img.youtube.com/vi/<VIDEO ID>/maxresdefault.jpg
https://img.youtube.com/vi/<VIDEO ID>/hqdefault.jpg

例子:

[![Watch the video](https://img.youtube.com/vi/T-D1KVIuvjA/maxresdefault.jpg)](https://youtu.be/T-D1KVIuvjA)

结果:

用asciinema

如果你的用例是在终端中运行的，asciinema可以让你记录一个终端会话，并且有很好的markdown嵌入。

点击分享按钮并复制标记下来的代码片段。

例子:

[![asciicast](https://asciinema.org/a/113463.png)](https://asciinema.org/a/113463)

结果: