Hébergement d'images Markdown : images pour README GitHub, documentation et notes

Obtenir le Markdown d'une image

1. Mettez l'image en ligne. Cliquez sur Mettre une image en ligne, ou, sur ordinateur, collez une capture d'écran directement depuis le presse-papiers avec Ctrl+V.
2. Ouvrez l'onglet Markdown une fois la mise en ligne terminée et copiez le code.
3. Collez-le dans votre fichier.

L'onglet Markdown fournit une image cliquable qui ouvre l'image en taille réelle :

[![AbC123xYz0](https://yourimageshare.com/ib/AbC123xYz0.png)](https://yourimageshare.com/ib/AbC123xYz0)

Pour une image simple sans lien, gardez seulement la partie intérieure et ajoutez un vrai texte alternatif :

![Settings screen](https://yourimageshare.com/ib/AbC123xYz0.png)

Images dans les README, issues et wikis GitHub

GitHub affiche les images externes dans les README, les issues, les pull requests, les discussions et les wikis. Collez le code Markdown et l'image apparaît lorsque la page est affichée.

• Définissez une taille avec une balise HTML, que GitHub autorise dans le Markdown : <img src="https://yourimageshare.com/ib/AbC123xYz0.png" width="400" alt="Screenshot">
• Les GIF de démonstration continuent de s'animer dans un README : découvrez l'hébergement de GIF, ou transformez un enregistrement d'écran en GIF avec le convertisseur de vidéo en GIF.
• Le texte alternatif décrit l'image pour les lecteurs d'écran et s'affiche si elle ne peut pas se charger.

Obsidian, Notion et sites de documentation

• Obsidian, Typora, l'aperçu VS Code et d'autres éditeurs Markdown affichent l'image à partir du lien : vos notes restent légères et l'image fonctionne sur tous vos appareils.
• Notion : tapez /image, choisissez Intégrer un lien et collez le lien direct (onglet Direct).
• Les sites de documentation créés avec MkDocs, Docusaurus, Jekyll, Hugo ou GitBook interprètent la même syntaxe Markdown pour les images.

Pourquoi héberger les images en dehors du dépôt

• Des dépôts plus légers. Les captures d'écran et les GIF ajoutent plusieurs mégaoctets à chaque clone, pour toujours, même après les avoir remplacés. Une image hébergée n'est chargée que lorsque quelqu'un consulte la page.
• Les liens n'expirent pas. Les images sont conservées jusqu'à ce que vous les supprimiez.
• Aucun compte nécessaire, et rien à configurer. Pour les scripts et la CI, il existe une API de mise en ligne gratuite.
• Pleine résolution et aucun filigrane. Les données EXIF, y compris la localisation, sont supprimées avant l'enregistrement de l'image.

Questions fréquentes