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

40

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?

nic
la source
Changez l'URL en un chemin complet complet avec HTTP et voyez où cela vous
mènera
@EightDaysofMalaise: Ça fait vraiment l'affaire ... Pourriez-vous écrire ceci comme réponse? J'ai signalé l'erreur de documentation à Github.
nic
Je pense que leur documentation a changé. "Image" , "image" et "logo" ne sont plus mentionnés sur la page.

Réponses:

34

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:

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, y compris le nom de domaine.

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

![Bilby Stampede](http://example.com/images/logo.png)
Huit jours de malaise
la source
24

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:

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

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.

Chris Morris
la source
Etes-vous sûr que la mise à jour inclut également l'utilisation de src?
Huit jours de Malaise le
1
Oui. Cependant, vous devez ajouter "? Raw = true" à la fin de l'URL. Voici un exemple :! [Image] (../ blob / master / public_html / img / nokia.png? Raw = true)
Chris Morris
Vient de mettre à jour la réponse :).
Chris Morris
1
Cela fonctionne pour mon fichier Markdown, mais j'obtiens une erreur avec pandoc: pandoc: erreur lors de la production d'un fichier PDF à partir de la source TeX. ! Erreur LaTeX: extension graphique inconnue: .png? Raw = true. Voir le manuel LaTeX ou LaTeX Companion pour des explications. Tapez H <retour> pour une aide immédiate. ... l.175 ... 2014-04-08_Bergman2011_Fig2.png? raw = true}
djhocking
2

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 imagessous-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)

brannerchinese
la source