如何将视频嵌入GitHub README.md?


Answers:


118

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

旧的支持线程“在markdown文件中嵌入YouTube视频”表示:

使用pages.github.io,是,在其他所有地方都没有。

(注:如“详细Github的顶级项目页 ”,github.io是为新的域用户和组织页自2013年四月
页面GitHub的出版物这里介绍

这可能是一个功能请求,例如语法突出显示了。

例如:“ Markdown中的HTML5视频 ”(2010年8月):

有什么方法可以在README.markdown文件中实现HTML5视频吗?

目前不是,但是将来我们可能会扩展自述文件的功能。

同时,您可以使用GitHub Pages和我们的Wiki进行此操作。


本杰明·奥克斯Benjamin Oakes)在评论中确认(2012年5月):

我发送了支持请求。响应是不支持嵌入视频。


2
这些联系似乎已经中断;他们现在带我到github.com/contact。有人可以访问存档版本吗?我很难将其从Google缓存或Wayback机中删除。
本杰明·奥克斯

1
对于Wiki页面中的HTML5视频而言,似乎不再有用。
本杰明·奥克斯

我发送了支持请求。响应是不支持嵌入视频。
本杰明·奥克斯

16
我可以在某个地方提出公开问题吗?
2014年

2
@hyipscript实际上不确定:引号来自5年的GitHub支持线程(我已经恢复了答案中的链接),来自[Chris Wanstrath-defunkt](github.com/defunkt),其中之一是GitHub的创始人。我没有更多的细节。
VonC

252

我强烈建议将视频放置在使用GitHub Pages创建的项目网站中,而不要使用自述文件,如 VonC的答案中所述;它将比这些想法中的任何一个都要好得多。但是,如果您像我一样需要快速修复,这里有一些建议。

使用gif

参阅aloisdg的答案,结果很棒,gifs在github的自述文件上呈现;)

使用视频播放器图片

您可以诱使用户认为视频在带有图片的自述页面上。这听起来像是个广告把戏,虽然不完美,但它确实有效而且很有趣;)。

例:

[![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>

预览网址是形式:

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可以让您记录终端会话并具有不错的markdown嵌入。

点击共享按钮,然后复制降价代码段。

例:

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

结果:

航天员


1
也有很酷的工具可以从您的助手那里创建gif或svg动画图像(例如github.com/marionebl/svg-term-cli; ;-)
JepZ

100

我将Alexandre JasminGab Le Roux的答案结合在一起,例如:

[![Demo CountPages alpha](https://share.gifyoutube.com/KzB6Gb.gif)](https://www.youtube.com/watch?v=ek1j272iAmc)

演示:

演示CountPages alpha

您可以在github上看到此演示。

我在这里使用了gifyoutube,但我建议使用本地gif转换器(例如ffmpeg,请参阅),而不要使用在线。

要将屏幕直接记录为gif,您可能需要选中ScreenToGif


1
我认为这应该是选择的答案。这是您所能获得的最接近视频的视频,对于大多数人来说,这视频。什么是视频?静止的帧按顺序移动,以给我们它正在播放的错觉。动画gif是一样的事情...尽管OP专门要求提供Flash视频,这是不可能的,但是您可以使用此方法将Flash视频转换为动画gif。
2015年

1
先生,你很聪明;我现在到处都在使用它。您可能要添加选择哪个网址,即直接网址(尽管我找不到share.gifyoutube.com网址)
Dheeraj Bhaskar

请注意,目前该站点为gifs.com,可从j.gifs.com下载并要求您具有gifs.com帐户才能进行下载
Jeroen Wiert Pluimers

1
对于Mac用户,Licecapscreentogif的不错替代品!
J.beenie

26

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


1
@HarishKayarohanam“直到github都具有此功能”,或者他们正在/或者正在从事这种工作?如果是这样,他们现在应该完成吗?:)
Paul

2
@Paul不,正如我几个月前所了解的那样,他们没有为此工作。请随意提出这个问题!github.com/github/markup/issues/538
彼得·德沃夏克(

执行此操作时,请考虑可访问性。如果注意力不集中的人旁边有可见的动画,他们可能会难以接受文本。
Eneroth3

6

只是为了扩展@GabLeRoux的答案:

[<img src="https://img.youtube.com/vi/<VIDEO ID>/maxresdefault.jpg" width="50%">](https://youtu.be/<VIDEO ID>)

这样,您将可以在Github存储库上调整README.md文件中缩略图的大小。


3

这是一篇旧文章,但我一直在寻找答案,却发现了这一点:https : //gifs.com。只需上传视频,然后创建一个gif即可轻松添加到github markdown中。我尝试过,gif的质量很好。

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.