GIF in GitHub-README einbinden
GitHub zeigt animierte GIFs in der README direkt über die Markdown-Bildsyntax an und spielt sie automatisch im Loop ab. Eine GIF-Demo eignet sich ideal, um die Funktion eines Tools in wenigen Sekunden zu zeigen. Da GitHub Dateien bis rund 10 MB rendert, lohnt sich eine schlanke Datei mit reduzierter Bildrate.
Empfohlene Breite
600-960 px
Maximale Dateigröße
10 MB Richtwert
Maximale Dauer
unter 12 Sekunden
Einbindung
Markdown: 
Schritt für Schritt
- 1 Nimm den Bildschirm-Ablauf deines Tools auf und lade ihn in den GIF-Maker.
- 2 Setze eine Breite zwischen 600 und 960 px für gute Lesbarkeit im Repo.
- 3 Kürze die Demo auf den Kern-Ablauf unter 12 Sekunden.
- 4 Reduziere die Bildrate auf 10-12 fps, um unter 10 MB zu bleiben.
- 5 Lege das GIF in deinem Repository ab, etwa im Ordner docs oder assets.
- 6 Verlinke es in der README per Markdown mit .
Tipp: Lege das GIF direkt im Repository ab statt auf einem externen Server, sonst verschwindet die Animation, falls der fremde Link irgendwann offline geht.
Anzeige
Anzeige
Weitere Anleitungen