Selon la documentation de GitHub , la syntaxe de Markdown pour insérer une image est la suivante:
![GitHub Logo](/images/logo.png)
Format: ![Alt Text](url)
Suivant leur exemple de syntaxe, je n'arrive pas à le faire fonctionner.
Même l'exemple du logo GitHub ne fonctionne pas.
Qu'est-ce que je rate? Ou est-ce un bug de GitHub?
Réponses:
Il se peut que vous manquiez le chemin / emplacement complet de l'image à inclure dans votre fichier Markdown.
L'exemple donné est un chemin relatif, où l'image repose sur le même serveur que le fichier. Dans l'aide, cela supposerait que l'image est réellement située à l'adresse suivante:
Mais ce n'est pas un fichier ou un emplacement valide.
Afin de vous assurer que vous pouvez restituer une image, peu importe d'où vous la visualisez, il est préférable d'inclure l'URL complète, y compris le nom de domaine.
Donc, votre exemple utiliserait plutôt quelque chose de similaire à ceci:
la source
En réponse à la réponse ci-dessus:
Depuis le 30 janvier 2013, GitHub autorise désormais les liens relatifs .
Assurez-vous cependant que vous ajoutez? Raw = true à la fin de l'URL. Voici un exemple:
En raison de la manière dont GitHub gère les URL, si vous n’ajoutez pas? Raw = true à l’URL source, votre navigateur tentera de charger la page qui affiche l’image.
la source
J'aime tester mon Markdown localement avant de pousser quelque part qui n'est visible que via une URL. Je veux donc une URL relative que je puisse utiliser n'importe où. GitHub les supporte maintenant.
Votre
images
sous-répertoire, en supposant qu'il se trouve dans le même répertoire que votre fichier Markdown, ne nécessite pas de barre oblique au début. Essayez:markdown ![GitHub Logo](images/logo.png)
au lieu de
markdown ![GitHub Logo](/images/logo.png)
la source