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

这样做的一个好方法是使用任何在线的mp4到gif转换器将视频转换为gif。 然后,

步骤:1在存储库中创建一个文件夹，可以存储所有想要显示的图像和视频。

步骤:2然后复制视频或图像的链接在存储库中，你试图显示。例如，你想从链接(https://github.com/Faizun-Faria/Thief-Robber-Landlord-Police/blob/main/Preview/gif_english.gif)显示游戏过程的视频。 您可以简单地在README中编写以下代码。Md文件显示gif:

![Game Process](https://github.com/Faizun-Faria/Thief-Robber-Landlord-Police/blob/main/Preview/gif_english.gif)

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文件中使用了一个。

在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)

结果:

这是第一个解决方案的老帖子和TLDR:

我刚刚打开了“编辑”我的Readme.md 拖放视频在自述编辑部分。 等待它上传并给你一个类似https://user-images.githubusercontent.com/的URL… 看预览，它只是工作!

Eg:

自述:https://github.com/s8sachin/subtitler/blob/master/README.md

Raw: https://raw.githubusercontent.com/s8sachin/subtitler/master/README.md

注意:

该文件不会存储在您的回购。 Webm不适合我，我用mp4代替。