Development5 min read

Fixing Broken Images in GitHub README.md Files

By Image Size Compress Team•

Large GIFs in READMEs look cool but slow down your repo page load. GitHub also proxies images, which can break if they are too large.

Optimize Assets

Convert your demo GIFs to WebP or optimized GIFs using our Tools. Store them in an `/assets` folder and use relative paths. Keeping assets small ensures your documentation loads instantly for users.

Try Our Free Image Compressor

Compress your images now with our easy-to-use tool!

Start Compressing

More Articles

Development

Dev Guide: Reduce AWS S3 Bills by 50% with WebP

Hosting terabytes of user images? Switching from PNG to WebP can slash your bandwidth and storage costs in half.