Cómo añadir imágenes al README de GitHub

Aprende a añadir imágenes a tu archivo README de GitHub usando sintaxis Markdown o enlaces de imágenes. Guía paso a paso para mostrar elementos visuales en tus repositorios.

Crea vídeos y documentación de producto impactantes con IA

Este tutorial se creó con Trupeer en menos de 5 minutos

Crea gratis

Guía paso a paso: cómo agregar imágenes al README de Github


Paso 1

Comienza navegando a la sección "Repositorios" en GitHub y haz clic en ella.

Begin by navigating to the "Repositories" section on GitHub and click on it.

Paso 2

Y luego haz clic en "Agregar README" para continuar.

Paso 3

Continúa seleccionando "Adjuntar archivos" y haz clic en ello para seguir.

Paso 4

Una vez cargado, haz clic en "Confirmar cambios".

Paso 5

Termina seleccionando "Confirmar cambios" de nuevo.

Consejos profesionales para agregar imágenes al README de GitHub

  1. Sube la imagen a tu repositorio
    Ve a tu repositorio de GitHub, haz clic en el botón Agregar archivo y luego elige Cargar archivos. Arrastra y suelta tu imagen o selecciónala desde tu computadora.

  2. Copia la URL de la imagen
    Una vez cargada, haz clic en el archivo de imagen. Se abrirá en una nueva página. Haz clic derecho en la imagen y selecciona Copiar dirección de la imagen.

  3. Abre o crea el archivo README.md
    Vuelve a tu repositorio. Si no hay un archivo README.md, haz clic en Agregar archivo y selecciona Crear archivo nuevo. Nómbralo README.md.

  4. Inserta la imagen usando la sintaxis Markdown
    Usa este formato para insertar la imagen en el archivo README:
    Reemplaza image-url con el enlace copiado y Alt text con una breve descripción de la imagen.

  5. Previsualiza y confirma los cambios
    Usa la pestaña Vista previa en el editor para comprobar cómo se ve la imagen. Si todo se ve bien, desplázate hacia abajo y haz clic en Confirmar cambios para guardar.

Errores comunes y cómo evitarlos

  1. La imagen no se carga
    Asegúrate de que la imagen esté almacenada en un repositorio público o alojada en una plataforma que admita enlaces directos a imágenes.

  2. Formato Markdown incorrecto
    El formato correcto es: comprueba de nuevo si faltan corchetes o paréntesis.

  3. Se usa una ruta de archivo local
    No uses rutas de archivos de tu computadora local. Utiliza solo URLs o rutas del repositorio.

  4. Enlace roto o desactualizado
    Si mueves o eliminas la imagen del repositorio, el enlace se romperá. Usa siempre la ruta final del archivo.

  5. Tamaño de imagen grande
    Redimensiona o comprime las imágenes grandes antes de subirlas para mantener tu README limpio y de carga rápida.

Preguntas frecuentes comunes sobre cómo agregar imágenes al README de GitHub

  1. ¿Cómo agrego una imagen local a un README de GitHub?
    Sube primero la imagen a tu repositorio y luego usa la sintaxis Markdown de imágenes para referenciarla.

  2. ¿Puedo usar una URL externa de imagen?
    Sí, cualquier URL de imagen disponible públicamente puede usarse en la sintaxis Markdown.

  3. ¿Cuál es la sintaxis Markdown correcta para agregar una imagen?
    El formato es

  4. ¿Puedo centrar la imagen en un archivo README?
    Markdown no admite el centrado directamente, pero puedes usar HTML como <p align="center"> para controlar el diseño.

  5. ¿Es posible redimensionar una imagen en README de GitHub?
    No con Markdown solo. Para controlar el tamaño, usa HTML básico como <img src="image-url" width="300"/> dentro del archivo README.

  6. ¿Cómo grabar la pantalla en Mac? 
    Para grabar la pantalla en un Mac, puedes usar Trupeer AI. Te permite capturar toda la pantalla y ofrece capacidades de IA como agregar avatares de IA, añadir voz en off y hacer zoom de entrada y salida en el video. Con la función de traducción de video con IA de Trupeer, puedes traducir el video a más de 30 idiomas. 

  7. ¿Cómo agregar un avatar de IA a una grabación de pantalla?
    Para agregar un avatar de IA a una grabación de pantalla, tendrás que usar una herramienta de grabación de pantalla con IA. Trupeer AI es una herramienta de grabación de pantalla con IA, que te ayuda a crear videos con múltiples avatares y también te ayuda a crear tu propio avatar para el video.

  8. ¿Cómo grabar la pantalla en Windows?
    Para grabar la pantalla en Windows, puedes usar la Barra de juegos integrada (Windows + G) o una herramienta avanzada de IA como Trupeer AI para funciones más avanzadas como avatares de IA, voz en off, traducción, etc.

  9. ¿Cómo añadir voz en off a un video?
    Para añadir voz en off a los videos, descarga la extensión de Chrome de Trupeer AI. Una vez registrado, sube tu video con voz, elige la voz en off deseada de Trupeer y exporta tu video editado. 

  10. ¿Cómo hago zoom en una grabación de pantalla?
    Para hacer zoom durante una grabación de pantalla, usa los efectos de zoom en Trupeer AI, que te permiten acercar y alejar en momentos específicos, mejorando el impacto visual del contenido de tu video.


¿Necesitas un editor de vídeo, un traductor y un guionista?

Prueba Trupeer gratis

Reserva una demo

¿Necesitas un editor de vídeo, un traductor y un guionista?

Prueba Trupeer gratis

Reserva una demo

¿Necesitas un editor de vídeo, un traductor y un guionista?

Prueba Trupeer gratis

Reserva una demo