Collectives™ on Stack Overflow

Find centralized, trusted content and collaborate around the technologies you use most.

Teams

Q&A for work

Connect and share knowledge within a single location that is structured and easy to search.

I want to show a large gif on README.md. Firstly, I uploaded it to imgur. And then, I added the url to README.md # <img alt="YAP" src="http://i.imgur.com/dNYswmI.gif"> . But it cannot be loaded, it was compiled to:

<a href="https://camo.githubusercontent.com/b4f1167e599ce7936bb83aad5d007ca8f04345ac/687474703a2f2f692e696d6775722e636f6d2f644e5973776d492e676966" target="_blank">
    <img alt="YAP" src="https://camo.githubusercontent.com/b4f1167e599ce7936bb83aad5d007ca8f04345ac/687474703a2f2f692e696d6775722e636f6d2f644e5973776d492e676966" data-canonical-src="http://i.imgur.com/dNYswmI.gif" style="max-width:100%;"></a>
This is my README.
###Description
  A open source player.
###Screenshot
# <img alt="YAP" src="http://i.imgur.com/dNYswmI.gif">
                GitHub strips out a lot of raw HTML. Any reason you didn't use Markdown syntax: ![YAP](http://i.imgur.com/dNYswmI.gif)?
– Waylan
                Jun 10, 2016 at 17:14
                I have updated it as you said but it doesn't either. Maybe it's because this gif is larger than 10m, github refuses to cache it. @Waylan
– Zen
                Jun 10, 2016 at 17:20
                "because this gif is larger than 10m: that is probably the problem. If so, there's nothing you can do about it except use a smaller file size.
– Waylan
                Jun 10, 2016 at 17:46
The gif you shared is 19MB in size.
GitHub routes all content through https://camo.githubusercontent.com/ even for external source now. Sharing a file that is bigger than the size limit (10MB) will get you a "Content length exceeded" error.
I tried sharing it on Google Drive, Dropbox, Droplr, my own server all ran into this issue unless the file size is below 5MB. It also doesn't matter if your syntax is in html or markdown.
<img src="https://static01.bbi.io/2Wt9Tk.gif"/>
!(image)[https://static01.bbi.io/2Wt9Tk.gif]
Your solution is to resize your gif. You can do it with service like this one: https://ezgif.com/resize .
GitHub does support Imgur embeds. Make sure to provide the image extension, which isn't on Imgurs default share hyperlink.
![Imgur Image](http://i.imgur.com/zTONrOD)
![Imgur Image](http://i.imgur.com/zTONrOD.jpg)
Imgur also provides this preformatted link under the MarkDown links menu, see image below.
See also an example readme.md with Imgur image.
                GitHub routes all content through camo.githubusercontent.com even for external source now. Sharing a file that is bigger than the size limit (10MB i think) will get you a "Content length exceeded" error.  I tried sharing it on Google Drive, Dropbox, Droplr, my own server all ran into this issue unless the file size is below 10MB.
– williamli
                Oct 12, 2017 at 5:16
                For using this in markdown. You will need to place an exclamation mark before the URL. So [Imgur](https://imgur.com/63riHy1) will be ![Imgur](https://imgur.com/63riHy1)
– Joshua
                May 21, 2020 at 3:07
You can still have a gif in readme.md that's above 10MB if you include the gif itself in your repository.
This is because images from the repository itself are not routed through 
 https://camo.githubusercontent.com/.
You could upload the gif to a misc folder and embed it like so:
<img src='./misc/your_file.gif'>
I believe the only way to link images from imgur would be something like this:
![An open source player](http://i.imgur.com/dNYswmI.gif)
However (in  my experience) GitHub does not support imgur, I do not know if there are any other supported image share service.
If you can't find a supported service just do something  like this as a last resort to just leave a link to the image:
###Description
A open source player.
### Screenshot
#[Screenshot](http://i.imgur.com/dNYswmI.gif)
                I believe Github doesn't support imgur's gifv format - google.ca/…  This means that any gif larger than 2MB wont work if you try to embed it in your README on github.
– Frikster
                Jun 21, 2017 at 21:18
I've run into this issue as well. Github will not allow you to upload anything over 10Mb. However, they offer an optional large file storage service specifically for audio/video/etc. This is what you want:
lfs-github
                If you use GitHub LFS, you get 1GB of storage and 1GB of mostly bandwidth transfer for free, after that charges apply: help.github.com/en/articles/…
– williamli
                Jul 16, 2019 at 3:17
        
Thanks for contributing an answer to Stack Overflow!
Please be sure to answer the question. Provide details and share your research!
But avoid …
Asking for help, clarification, or responding to other answers.
Making statements based on opinion; back them up with references or personal experience.
To learn more, see our tips on writing great answers.