Hosting de imágenes para Markdown: imágenes para README de GitHub, documentación y notas

Por el equipo de producto

Sube una captura de pantalla, un diagrama o un GIF. Obtienes el Markdown listo para pegar en un README, una wiki o tus notas: gratis, sin registro y el enlace no caduca.

Subir una imagen

★ Valoración 4.4/5 según 137 valoraciones de usuarios

Markdown muestra una imagen a partir de un enlace: ![texto alternativo](enlace de la imagen). La imagen tiene que estar alojada en algún lugar de la web. YourImageShare la aloja gratis y te da la línea de Markdown lista para pegar, para GitHub, GitLab, Obsidian, sitios de documentación o cualquier otro archivo Markdown.

Obtén el Markdown de una imagen

Sube la imagen. Pulsa Subir una imagen o, en una computadora, pega una captura de pantalla directamente desde el portapapeles con Ctrl+V.
Abre la pestaña Markdown cuando termine la subida y copia el código.
Pégalo en tu archivo.

La pestaña Markdown ofrece una imagen con enlace que abre la imagen a tamaño completo:

[![AbC123xYz0](https://yourimageshare.com/ib/AbC123xYz0.png)](https://yourimageshare.com/ib/AbC123xYz0)

Para una imagen simple sin enlace, conserva solo la parte interior y escribe un texto alternativo descriptivo:

![Settings screen](https://yourimageshare.com/ib/AbC123xYz0.png)

Imágenes en README, issues y wikis de GitHub

GitHub muestra imágenes externas en README, issues, pull requests, discussions y wikis. Pega el código Markdown y la imagen aparecerá cuando se renderice la página.

Define un tamaño con una etiqueta HTML, que GitHub permite en Markdown: <img src="https://yourimageshare.com/ib/AbC123xYz0.png" width="400" alt="Screenshot">
Los GIF de demostración siguen reproduciéndose en un README: consulta hosting de GIF o convierte una grabación de pantalla en GIF con el convertidor de video a GIF.
El texto alternativo describe la imagen para los lectores de pantalla y se muestra si no se puede cargar.

Obsidian, Notion y sitios de documentación

Obsidian, Typora, la vista previa de VS Code y otros editores de Markdown muestran la imagen a partir del enlace, así que tus notas pesan poco y la imagen funciona en todos tus dispositivos.
Notion: escribe /image, elige Insertar enlace y pega el enlace directo (la pestaña Directo).
Los sitios de documentación creados con MkDocs, Docusaurus, Jekyll, Hugo o GitBook interpretan la misma sintaxis de imágenes de Markdown.

Por qué alojar las imágenes fuera del repositorio

Repositorios más pequeños. Las capturas de pantalla y los GIF añaden megabytes a cada clon, para siempre, incluso después de reemplazarlos. Una imagen alojada solo se carga cuando alguien ve la página.
Los enlaces no caducan. Las imágenes se conservan hasta que las elimines.
Sin necesidad de cuenta ni nada que configurar. Para scripts y CI, hay una API de subida gratis.
Resolución completa y sin marca de agua. Los datos EXIF, incluida la ubicación, se eliminan antes de guardar la imagen.

Preguntas frecuentes

¿Cómo agrego una imagen a un archivo Markdown?

Sube la imagen, copia el código de la pestaña Markdown y pégalo en el archivo. Markdown muestra una imagen con ![texto alternativo](enlace de la imagen).

¿Puedo usar estas imágenes en un README de GitHub?

Sí. GitHub muestra imágenes externas en README, issues, pull requests y wikis. Pega el código Markdown y la imagen aparecerá cuando se renderice el archivo.

¿Cómo defino el tamaño de una imagen en un README?

Markdown simple no tiene opción de tamaño. En GitHub, usa una etiqueta de imagen HTML con ancho, por ejemplo <img src="enlace de la imagen" width="400" alt="Captura de pantalla">.

¿Por qué alojar las imágenes del README fuera del repositorio?

Las capturas de pantalla y los GIF de demostración añaden megabytes a cada clon del repositorio. Una imagen alojada solo se carga cuando alguien ve el README.

¿Los enlaces de las imágenes caducan?

No. Las imágenes se conservan hasta que las elimines, así que los enlaces en la documentación siguen funcionando.

Más casos de uso

¿Listo para agregar tu imagen?