Markdown, aby wstawić i wyświetlić obraz w repozytorium GitHub

40

Zgodnie z dokumentacją GitHub składnia Markdown do wstawiania obrazu to:

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

Zgodnie z ich przykładową składnią nie wydaje mi się, aby był w stanie sprawić, by działał.

Nawet przykład logo GitHub nie działa.

czego mi brakuje? Czy jest to błąd GitHub?

github markdown

— nic
źródło

Zmień adres URL na pełną ścieżkę wraz z HTTP i sprawdź, dokąd cię to zaprowadzi

— Osiem dni złego samopoczucia

@EightDaysofMalaise: To rzeczywiście podstęp ... Czy mógłbyś napisać to jako odpowiedź? Zgłosiłem błąd w dokumentacji do Github.

— nic

Myślę, że ich dokumentacja się zmieniła. „Obraz” , „obraz” i „logo” nie są już wymienione na stronie.

34

Być może brakuje pełnej ścieżki / lokalizacji do obrazu, który chcesz dołączyć do pliku Markdown.

Podany przykład to ścieżka względna, w której obraz spoczywa na tym samym serwerze, co plik. W pomocy przyjęto by, że obraz faktycznie znajduje się w:

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

Ale to nie jest prawidłowy plik lub lokalizacja.

Aby mieć pewność, że możesz renderować obraz bez względu na to, skąd go oglądasz, bezpieczniej jest podać pełny adres URL, który zawierałby nazwę domeny.

Więc twój przykład zamiast tego używałby czegoś podobnego do tego:

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

— Osiem dni złego samopoczucia
źródło

24

W odpowiedzi na powyższą odpowiedź:

Na dzień 30 stycznia 2013 r. GitHub zezwala teraz na linki względne .

Upewnij się jednak, że dołączasz? Raw = true na końcu adresu URL. Oto przykład:

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

Ze względu na sposób, w jaki GitHub obsługuje adresy URL, jeśli nie dołączasz? Raw = true do źródłowego adresu URL, przeglądarka podejmie próbę załadowania strony, na której wyświetlany jest obraz.

— Chris Morris
źródło

Czy na pewno aktualizacja obejmuje również używanie jako src?

— Osiem dni złego samopoczucia

1

Tak. Jednak musisz dołączyć „? Raw = true” na końcu adresu URL. Oto przykład :! [Image] (../ blob / master / public_html / img / nokia.png? Raw = true)

— Chris Morris

Właśnie zaktualizowałem odpowiedź :).

— Chris Morris

1

Działa to dla mojego pliku Markdown, ale pojawia się błąd z pandoc: pandoc: Błąd podczas tworzenia pliku PDF ze źródła TeX. ! Błąd LaTeX: Nieznane rozszerzenie grafiki: .png? Raw = true. Wyjaśnienia znajdują się w instrukcji LaTeX lub LaTeX Companion. Aby uzyskać natychmiastową pomoc, wpisz H <powrót>. ... l.175 ... 2014-04-08_Bergman2011_Fig2.png? raw = true}

— djhocking 8'14

2

Lubię testować mój Markdown lokalnie, zanim wypchnę gdzieś, gdzie można go zobaczyć tylko przez URL. Chcę więc względnego adresu URL, którego mogę używać w dowolnym miejscu. GitHub obsługuje je teraz.

Twój imagespodkatalog, zakładając, że znajduje się w tym samym katalogu co plik Markdown, na początku nie potrzebuje ukośnika - spróbuj:

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

zamiast

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

— brannerchinese
źródło