web-dev-qa-db-fra.com

Markdown pour insérer et afficher une image sur le dépôt GitHub

Selon le documentation 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?

41
nic

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 à:

https://github.com/images/logo.png

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, qui comprendrait le nom de domaine.

Donc, votre exemple utiliserait plutôt quelque chose de similaire à ceci:

![Bilby Stampede](http://example.com/images/logo.png)
35

En réponse à la réponse ci-dessus:

Au 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:

![Image](../blob/master/public_html/img/nokia.png?raw=true)

En raison de la manière dont GitHub traite les URL, si vous n’ajoutez pas? Raw = true à l’URL source, votre navigateur tentera de charger la page qui affiche l’image.

25
Chris Morris

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 sous-répertoire images, 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)

2
brannerchinese