Markdown para inserir e exibir uma imagem no repositório do GitHub

40

De acordo com a documentação do GitHub , a sintaxe do Markdown para inserir uma imagem é:

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

Seguindo a sintaxe de exemplo, parece que não consigo fazê-lo funcionar.

Mesmo o exemplo do logotipo do GitHub não funciona.

o que estou perdendo? Ou é um bug do GitHub?

nic
fonte
Alterar o URL para um completo caminho completo com o HTTP e ver onde que leva você
oito dias de Malaise
@EightDaysofMalaise: Isso realmente funciona ... Você poderia escrever isso como resposta? Eu relatei o erro de documentação ao Github.
nic
Eu acho que a documentação deles mudou. "Imagem" , "imagem" e "logotipo" não são mais mencionados na página.

Respostas:

34

Pode estar faltando o caminho completo / local da imagem que você deseja incluir no seu arquivo Markdown.

O exemplo dado é um caminho relativo, em que a imagem fica no mesmo servidor que o arquivo. Na ajuda, assumiria que a imagem está realmente localizada em:

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

Mas esse não é um arquivo ou local válido.

Para garantir que você possa renderizar uma imagem, não importa de onde a esteja visualizando, é mais seguro incluir o URL completo, que incluiria o nome do domínio.

Portanto, seu exemplo seria usar algo semelhante a este:

![Bilby Stampede](http://example.com/images/logo.png)
Oito Dias de Mal-estar
fonte
24

Em resposta à resposta acima:

Em 30 de janeiro de 2013, o GitHub agora permite links relativos .

Lembre-se de anexar? Raw = true ao final do URL. Aqui está um exemplo:

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

Devido à maneira como o GitHub lida com os URLs, se você não anexar? Raw = true ao URL de origem, seu navegador tentará carregar a página que exibe a imagem.

Chris Morris
fonte
Tem certeza de que a atualização também inclui o uso como src?
Oito dias de Malaise
1
Sim. No entanto, você deve anexar "? Raw = true" ao final do URL. Aqui está um exemplo: ! [Imagem] (? ../ blob / master / public_html / img / nokia.png raw = true)
Chris Morris
Apenas atualizei a resposta :).
Chris Morris
1
Isso funciona para o meu arquivo Markdown, mas recebo um erro com pandoc: pandoc: Erro ao produzir PDF a partir da fonte TeX. ! Erro no LaTeX: Extensão gráfica desconhecida: .png? Raw = true. Consulte o manual do LaTeX ou o LaTeX Companion para obter explicações. Digite H <retorno> para obter ajuda imediata. ? ... l.175 ... 2014-04-08_Bergman2011_Fig2.png = matérias-true}
djhocking
2

Gosto de testar meu Markdown localmente antes de enviar para algum lugar visível apenas por meio de um URL. Então, eu quero uma URL relativa que eu possa usar em qualquer lugar. O GitHub agora suporta isso.

Seu imagessubdiretório, supondo que esteja no mesmo diretório que o arquivo Markdown, não precisa de uma barra no início - tente:

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

ao invés de

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

brannerchinese
fonte