La etiqueta <img>
Para mostrar una imagen se usa <img>, un elemento vacío (sin etiqueta de cierre) con dos atributos imprescindibles:
<img src="perro.jpg" alt="Un perro marrón corriendo por la playa">
src(source, origen): la ruta de la imagen. Funciona igual que elhrefde los enlaces: puede ser relativa (fotos/perro.jpg) o absoluta (https://…).alt(alternative text): la descripción de la imagen en texto.
Tab añade una sangría. Pulsa Escape y luego Tab para salir del editor.
Imágenes de tu proyecto
Lo normal es guardar las imágenes dentro de la carpeta del proyecto, a menudo en una subcarpeta propia:
mi-web/
├── index.html
└── img/
├── perfil.jpg
└── logo.svg
<img src="img/perfil.jpg" alt="Mi foto de perfil sonriendo">
El texto alternativo importa
El atributo alt es obligatorio, y no es un trámite. Lo usan:
- Las personas ciegas: su lector de pantalla lee el
alten voz alta. - Los buscadores: Google no «ve» las fotos; lee su
alt. - Todo el mundo, cuando la imagen no carga.
Cómo escribir un buen alt:
| Situación | ❌ Mal | ✅ Bien |
|---|---|---|
| Foto de producto | alt="zapatilla" | alt="Zapatilla de running roja con suela blanca" |
| Foto con información | alt="gráfico" | alt="Las ventas se duplicaron de enero a marzo" |
| Un logotipo que enlaza a la portada | alt="logo" | alt="Panadería Lola, ir al inicio" |
| Adorno sin información | alt="adorno" | alt="" (vacío) |
Tamaño: width y height
Puedes indicar el ancho y el alto de la imagen en píxeles, sin escribir px:
<img src="perro.jpg" alt="Un perro marrón" width="600" height="400">
Aunque luego cambies el tamaño con CSS, conviene ponerlos: así el navegador reserva el hueco mientras la imagen se descarga y el texto no da saltos. Escribe el tamaño real de la imagen (o en la misma proporción).
Pies de foto: <figure> y <figcaption>
Cuando una imagen lleva un pie de foto, se agrupan con <figure>:
Tab añade una sangría. Pulsa Escape y luego Tab para salir del editor.
¿Qué formato elijo?
| Formato | Úsalo para | Ventaja |
|---|---|---|
| JPG | Fotografías | Pesa poco con muchos colores |
| PNG | Capturas de pantalla, imágenes con transparencia | Nítido, admite fondo transparente |
| SVG | Logotipos, iconos, ilustraciones sencillas | Nunca se pixela, a cualquier tamaño |
| WebP / AVIF | Fotos en webs modernas | Mucho más ligeros que JPG |
| GIF | Animaciones cortas | Se anima (pero pesa mucho) |
Vídeo y audio
HTML también reproduce vídeo y audio sin nada más. El atributo controls muestra los botones de reproducir, volumen, etc.:
<video src="video/paseo.mp4" controls width="640"></video>
<audio src="audio/podcast.mp3" controls></audio>
A diferencia de <img>, estos sí llevan etiqueta de cierre. Para vídeos de YouTube o mapas de Google Maps, esos servicios te dan un código ya hecho (un <iframe>) en su botón Compartir → Insertar: solo tienes que copiarlo y pegarlo.
Errores típicos
- Olvidar el
alto escribir cosas comoalt="imagen". - Confundir
srcconhref. Las imágenes usansrc; los enlaces,href. - Rutas mal escritas: una mayúscula de más, la carpeta equivocada o una ruta de tu ordenador (
C:\…). - Subir fotos enormes directamente desde la cámara o el móvil.
- Escribir
</img>.<img>es un elemento vacío: no se cierra.
Ejercicios
Ejercicio 1: arregla las imágenes (fácil)
Estas imágenes tienen errores. Corrígelos para que se vean y sean accesibles.
Tab añade una sangría. Pulsa Escape y luego Tab para salir del editor.
Pista
Revisa el nombre del atributo de la ruta, si falta algún alt, si los alt son descriptivos y si alguna etiqueta sobra.
Solución
<img src="https://picsum.photos/id/1025/300/200" alt="Un perro carlino envuelto en una manta">
<img src="https://picsum.photos/id/1084/300/200" alt="Morsas descansando sobre las rocas">
Los textos pueden ser otros: lo importante es que describan lo que se ve.
Ejercicio 2: galería con pies de foto (medio)
Crea una pequeña galería con tres <figure>, cada una con una imagen (usa direcciones como https://picsum.photos/id/10/300/200, cambiando el número), su alt, su width y height, y un <figcaption>.
Tab añade una sangría. Pulsa Escape y luego Tab para salir del editor.
Pista
Copia el ejemplo de <figure> de la lección tres veces y cambia los números de las imágenes y los textos.
Solución
<h2>Mis viajes</h2>
<figure>
<img src="https://picsum.photos/id/10/300/200" alt="Bosque junto a un lago" width="300" height="200">
<figcaption>Asturias, 2024.</figcaption>
</figure>
<figure>
<img src="https://picsum.photos/id/15/300/200" alt="Río con rocas y cascada" width="300" height="200">
<figcaption>Pirineos, 2025.</figcaption>
</figure>
<figure>
<img src="https://picsum.photos/id/1015/300/200" alt="Río entre montañas" width="300" height="200">
<figcaption>Alpes, 2026.</figcaption>
</figure>
Ejercicio 3: imagen que enlaza (medio)
Haz que una imagen sea un enlace a https://es.wikipedia.org. Piensa qué alt necesita ahora.
Tab añade una sangría. Pulsa Escape y luego Tab para salir del editor.
Pista
Mete el <img> dentro del <a>. Como la imagen es lo único que hay en el enlace, su alt debe decir a dónde lleva.
Solución
<a href="https://es.wikipedia.org">
<img src="https://picsum.photos/id/24/200/120" alt="Ir a Wikipedia" width="200" height="120">
</a>
Ficha resumen
<img src="ruta" alt="descripción">es un elemento vacío.altsiempre: describe lo que aporta la imagen. Si es solo decoración,alt="".widthyheightreservan el hueco mientras carga.<figure>+<figcaption>para imagen con pie de foto.- JPG para fotos, PNG para transparencias, SVG para logos e iconos, WebP para fotos ligeras.
<video controls>y<audio controls>reproducen multimedia.
Glosario
| Término | Definición |
|---|---|
<img> | Elemento vacío que muestra una imagen. |
src | Atributo con la ruta del archivo de una imagen, vídeo o audio (source). |
alt | Texto alternativo que describe una imagen para quien no puede verla. |
<figure> | Elemento que agrupa una imagen (u otro contenido) con su pie. |
<figcaption> | Pie de foto dentro de un <figure>. |
| Píxel | Cada uno de los puntitos que forman una imagen o una pantalla. |
| SVG | Formato de imagen vectorial: hecho de formas, se ve nítido a cualquier tamaño. |
<video> | Elemento que reproduce un vídeo. Con controls muestra los botones de reproducción. |