Imágenes en Markdown con contexto útil
Elige fuentes fiables, escribe descripciones útiles y revisa el resultado exportado antes de compartir una imagen Markdown.
Una imagen en Markdown necesita algo más que un enlace válido. El lector debe entender qué muestra, por qué está ahí y dónde encontrar la fuente editable. Usa el conversor Markdown para revisar toda la composición antes de compartirla como imagen.
La ilustración debe explicar un punto que el texto realmente trate. Una lista de comprobación puede mostrar una revisión pendiente; una foto decorativa de un portátil no comunica ese estado. Coloca la explicación cerca de la imagen para que el lector no tenga que adivinar su significado.
En la sintaxis de imágenes de Markdown, la descripción va entre corchetes y la fuente entre paréntesis. La especificación CommonMark documenta esta estructura. Una descripción útil indica lo relevante en ese contexto, en lugar de repetir un nombre de archivo o decir solo «imagen».
Esta demostración utiliza una imagen de lista de comprobación proporcionada. Mantén juntos la descripción y el texto inferior: la primera explica la imagen y el segundo aclara que la fuente sigue siendo editable.
# Image with useful context
The source document remains editable; the exported card is for sharing.
El resultado combina imagen y texto para una actualización de revisión interna. No es una copia editable de la lista original. Si la tarea pendiente es esencial para el mensaje, menciónala también en el texto que acompañe a la publicación.
Abre primero la URL directamente y comprueba que muestra la imagen prevista. Una dirección copiada puede llevar a una página para compartir, a un enlace caducado o a un archivo que requiere tu sesión iniciada. Una ruta relativa válida en un repositorio puede carecer de sentido en un editor web independiente.
Usa una fuente que controles y tengas permiso para compartir. No publiques una captura privada solo para que cargue: oculta los datos sensibles o elige una imagen de demostración segura. Tras cambiar la URL, comprueba el acceso y revisa la vista previa antes de exportar.
Las etiquetas pequeñas de una captura ancha pueden seguir siendo ilegibles aunque la tarjeta quede ordenada. Recorta las áreas de interfaz ajenas al tema y conserva la zona que explica el punto. Evita ampliar una fuente diminuta: aumentar el tamaño de exportación no recupera detalles ausentes en el original.
Revisa la imagen incrustada y el texto circundante en el archivo descargado al tamaño en que se mostrarán. Añade una explicación textual accesible a la publicación: las descripciones de la fuente Markdown no sustituyen al texto alternativo de la imagen exportada.
Previsualiza tu Markdown con imágenes antes de publicarlo.
Guías relacionadas: colocar dos imágenes en paralelo y exportar Markdown como PNG.