Markdown per inserire e visualizzare un'immagine sul repository GitHub

40

Secondo la documentazione di GitHub , la sintassi Markdown per l'inserimento di un'immagine è:

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

Seguendo la loro sintassi di esempio, non riesco a farlo funzionare.

Anche l'esempio del logo GitHub non funziona.

Cosa mi sto perdendo? O è un bug di GitHub?

github markdown

— nic
fonte

Cambia l'URL in un percorso completo completo di HTTP e vedi dove ti porta

— Otto giorni di malessere

@EightDaysofMalaise: Questo è davvero il trucco ... Potresti per favore scrivere questo come risposta? Ho segnalato l'errore di documentazione a Github.

— nic

Penso che la loro documentazione sia cambiata. "Immagine" , "immagine" e "logo" non sono più menzionati nella pagina.

34

Potrebbe mancare l'intero percorso / posizione all'immagine che si desidera includere nel file Markdown.

L'esempio fornito è un percorso relativo, in cui l'immagine si trova sullo stesso server del file. Nell'aiuto, si presume che l'immagine si trovi effettivamente in:

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

Ma questo non è un file o percorso valido.

Per assicurarti di poter eseguire il rendering di un'immagine indipendentemente da dove la stai visualizzando, è più sicuro includere l'URL completo, che includerebbe il nome di dominio.

Quindi il tuo esempio sarebbe invece usare qualcosa di simile a questo:

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

— Otto giorni di malessere
fonte

24

In risposta alla risposta sopra:

Al 30 gennaio 2013, GitHub ora consente collegamenti relativi .

Assicurati di aggiungere? Raw = true alla fine dell'URL, comunque. Ecco un esempio:

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

A causa del modo in cui GitHub gestisce gli URL, se non si aggiunge? Raw = true all'URL di origine, il browser tenterà di caricare la pagina che visualizza l'immagine.

— Chris Morris
fonte

Sei sicuro che l'aggiornamento includa anche l'uso come src?

— Otto giorni di malessere

1

Sì, lo fa. Tuttavia, devi aggiungere "? Raw = true" alla fine dell'URL. Ecco un esempio :! [Immagine] (../ blob / master / public_html / img / nokia.png? Raw = true)

— Chris Morris,

Ho appena aggiornato la risposta :).

— Chris Morris,

1

Funziona con il mio file Markdown ma ricevo un errore con pandoc: pandoc: errore nella produzione di PDF dall'origine TeX. ! Errore LaTeX: estensione grafica sconosciuta: .png? Raw = true. Consultare il manuale LaTeX o LaTeX Companion per una spiegazione. Digitare H <ritorno> per un aiuto immediato. ... l.175 ... 08-04-2014_Bergman2011_Fig2.png? raw = true}

— djhocking

2

Mi piace testare il mio Markdown localmente prima di spingere da qualche parte visibile solo attraverso un URL. Quindi voglio un URL relativo che posso usare ovunque. GitHub ora supporta quelli.

La tua imagessottodirectory, supponendo che sia nella stessa directory del tuo file Markdown, all'inizio non ha bisogno di una barra - prova:

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

invece di

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

— brannerchinese
fonte