Markdown para insertar y mostrar una imagen en el repositorio de GitHub

40

Según la documentación de GitHub , la sintaxis de Markdown para insertar una imagen es:

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

Siguiendo su sintaxis de ejemplo, parece que no puedo hacer que funcione.

Incluso el ejemplo del logotipo de GitHub no funciona.

¿Qué me estoy perdiendo? ¿O es un error de GitHub?

nic
fuente
Cambie la URL a una ruta completa completa con HTTP y vea a dónde lo lleva
Ocho días de malestar el
@EightDaysofMalaise: De hecho, ese es el truco ... ¿Podría escribir esto como respuesta? Informé el error de documentación a Github.
nic
Creo que su documentación cambió. "Imagen" , "imagen" y "logotipo" ya no se mencionan en la página.

Respuestas:

34

Es posible que le falte la ruta / ubicación completa de la imagen que desea incluir en su archivo Markdown.

El ejemplo dado es una ruta relativa, donde la imagen descansa en el mismo servidor que el archivo. En la ayuda, supondría que la imagen se encuentra realmente en:

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

Pero ese no es un archivo o ubicación válido.

Para asegurarse de que puede representar una imagen sin importar desde dónde la esté viendo, es más seguro incluir la URL completa, que incluiría el nombre de dominio.

Entonces, su ejemplo sería usar algo similar a esto:

![Bilby Stampede](http://example.com/images/logo.png)
Ocho días de malestar
fuente
24

En respuesta a la respuesta anterior:

A partir del 30 de enero de 2013, GitHub ahora permite enlaces relativos .

Sin embargo, asegúrese de agregar? Raw = true al final de la URL. Aquí hay un ejemplo:

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

Debido a la forma en que GitHub maneja las URL, si no agrega? Raw = true a la URL de origen, su navegador intentará cargar la página que muestra la imagen.

Chris Morris
fuente
¿Estás seguro de que la actualización también incluye el uso como src?
Ocho días de malestar
1
Sí lo hace. Sin embargo, debe agregar "? Raw = true" al final de la URL. Aquí hay un ejemplo :! [Imagen] (../ blob / master / public_html / img / nokia.png? Raw = true)
Chris Morris
Acabo de actualizar la respuesta :).
Chris Morris
1
Esto funciona para mi archivo Markdown pero recibo un error con pandoc: pandoc: Error al producir PDF desde la fuente TeX. ! Error de LaTeX: extensión de gráficos desconocida: .png? Raw = true. Consulte el manual de LaTeX o LaTeX Companion para obtener una explicación. Escriba H <return> para obtener ayuda inmediata. ... l.175 ... 2014-04-08_Bergman2011_Fig2.png? raw = true}
djhocking
2

Me gusta probar mi Markdown localmente antes de presionar en algún lugar visible solo a través de una URL. Entonces, quiero una URL relativa que pueda usar en cualquier lugar. GitHub ahora los admite.

Su imagessubdirectorio, suponiendo que esté en el mismo directorio que su archivo Markdown, no necesita una barra al principio - intente:

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

en lugar de

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

Brannerchinese
fuente