Markdown zum Einfügen und Anzeigen eines Bildes auf GitHub Repo

41

Laut der GitHub-Dokumentation lautet die Markdown-Syntax zum Einfügen eines Bildes:

![GitHub Logo](/images/logo.png)
Format: ![Alt Text](url)

Nach ihrer Beispielsyntax kann ich es scheinbar nicht zum Laufen bringen.

Auch das GitHub-Logo-Beispiel funktioniert nicht.

Was vermisse ich? Oder ist es ein GitHub-Fehler?

github markdown nett
quelle
Ändern Sie die URL in einen vollständigen Pfad mit dem HTTP und sehen Sie, wohin das führt
Acht Tage Unwohlsein
@EightDaysofMalaise: Das ist in der Tat der Trick ... Könnten Sie dies bitte als Antwort schreiben? Ich habe den Dokumentationsfehler an Github gemeldet.
Nic
Ich denke, ihre Dokumentation hat sich geändert. "Bild" , "Bild" und "Logo" werden auf der Seite nicht mehr erwähnt.
Jww

Antworten:

35

Möglicherweise fehlt der vollständige Pfad / Speicherort zu dem Bild, das Sie in Ihre Markdown-Datei aufnehmen möchten.

Das angegebene Beispiel ist ein relativer Pfad, in dem sich das Image auf demselben Server wie die Datei befindet. In der Hilfe wird davon ausgegangen, dass sich das Bild tatsächlich unter folgender Adresse befindet:

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

Dies ist jedoch keine gültige Datei oder Position.

Um sicherzustellen, dass Sie ein Bild rendern können, unabhängig davon, wo Sie es betrachten, ist es sicherer, die vollständige URL anzugeben, die den Domainnamen enthält.

Ihr Beispiel würde also stattdessen etwas Ähnliches verwenden:

![Bilby Stampede](http://example.com/images/logo.png)
Acht Tage Unwohlsein
quelle
25

Als Antwort auf die Antwort oben:

Ab dem 30. Januar 2013 erlaubt GitHub nun relative Links .

Stellen Sie jedoch sicher, dass Sie? Raw = true an das Ende der URL anhängen. Hier ist ein Beispiel:

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

Aufgrund der Art und Weise, wie GitHub URLs verarbeitet, wird Ihr Browser versuchen, die Seite zu laden, auf der das Bild angezeigt wird, wenn Sie? Raw = true nicht an die Quell-URL anhängen.

Chris Morris
quelle
Sind Sie sicher, dass das Update auch die Verwendung von as src beinhaltet?
Acht Tage Unwohlsein
1
Ja tut es. Sie müssen jedoch "? Raw = true" an das Ende der URL anhängen. Hier ist ein Beispiel :! [Image] (../ blob / master / public_html / img / nokia.png? Raw = true)
Chris Morris
Habe gerade die Antwort aktualisiert :).
Chris Morris
1
Dies funktioniert für meine Markdown-Datei, aber bei pandoc tritt ein Fehler auf: pandoc: Fehler beim Erstellen von PDF-Dateien aus TeX-Quellen. ! LaTeX-Fehler: Unbekannte Grafikerweiterung: .png? Raw = true. Weitere Informationen finden Sie im LaTeX-Handbuch oder im LaTeX Companion. Geben Sie H <return> ein, um sofort Hilfe zu erhalten. ... l.175 ... 2014-04-08_Bergman2011_Fig2.png? raw = true}
djhocking
2

Ich teste meinen Markdown gerne lokal, bevor ich ihn über eine URL an einen anderen Ort schiebe, der nur angezeigt werden kann. Ich möchte also eine relative URL, die ich überall verwenden kann. GitHub unterstützt diese jetzt.

Ihr imagesUnterverzeichnis muss, sofern es sich im selben Verzeichnis wie Ihre Markdown-Datei befindet, am Anfang keinen Schrägstrich enthalten - versuchen Sie Folgendes:

markdown ![GitHub Logo](images/logo.png)

Anstatt von

markdown ![GitHub Logo](/images/logo.png)

brannerchinese
quelle