How to Embed GIFs in GitHub README
Complete guide to embedding animated GIFs in GitHub README files with Markdown, HTML, and iframe embeds.
1. Markdown Embed
[](https://agentgif.com/YOUR_ID)
2. HTML img Embed
<a href="https://agentgif.com/YOUR_ID"><img src="https://media.agentgif.com/YOUR_ID.gif" alt="demo" width="800"></a>
3. iframe Embed
<iframe src="https://agentgif.com/embed/YOUR_ID/" width="800" height="500" frameborder="0"></iframe>
4. Script Widget
<div data-agentgif="YOUR_ID"></div>
<script src="https://agentgif.com/widget.js" async></script>
5. oEmbed
Platforms supporting oEmbed (Notion, Slack, Discord) auto-detect via the <link rel="alternate"> tag.
6. Badge
