¿Qué formato copiar primero?
La URL directa para verificar la carga; luego Markdown, HTML o BBCode.
Formatos de inserción
Usar enlaces de imagen en Markdown, HTML y BBCode
Compara URL directa, Markdown, HTML y BBCode para la misma imagen y corrige cuando no se muestra.
URL directaMarkdown / HTML / BBCodeMisma demo
Elige el formato según el destino
La mayoría de los problemas de inserción vienen de pegar un enlace válido con la sintaxis equivocada. Parte del lugar donde aparecerá la imagen: ¿qué acepta ese editor y debe mostrar la imagen o solo enlazarla?
- Apps de chat, correo y tickets de soporte: pega la URL directa. Muchos muestran una vista previa automáticamente y el enlace sigue funcionando aunque la vista previa se bloquee.
- GitHub, GitLab, sitios de documentación y apps de notas: usa Markdown y cambia el texto alternativo por defecto por una breve descripción de la imagen, por ejemplo una página de ajustes con el botón Guardar resaltado.
- Editores CMS y páginas web escritas a mano: usa HTML cuando necesites controlar el tamaño. Añadir width="600" a la etiqueta img evita que una captura grande descuadre el diseño.
- Foros con phpBB, vBulletin, MyBB o software similar: usa BBCode. Algunos foros solo admiten imágenes de servicios aprobados; si la etiqueta [img] muestra un recuadro vacío, publica la URL directa como enlace normal.
Misma imagen demo, cuatro salidas
Los ejemplos usan un recurso del sitio para comparar sin depender de una subida de usuario que caduca.
Vista previa real
Si la vista previa carga, la URL directa funciona en una pestaña normal.
https://assets.mini-tools.uk/image/icon-512x512.png
URL directa
Pégala en chats, tickets o herramientas que pidan una URL de imagen.
https://assets.mini-tools.uk/image/icon-512x512.pngMarkdown
Para README de GitHub, docs y editores Markdown.
HTML
Solo donde el editor acepte la etiqueta img.
<img src="https://assets.mini-tools.uk/image/icon-512x512.png" alt="Mini Tools demo">BBCode
Solo para foros que admiten etiquetas [img] clásicas.
[img]https://assets.mini-tools.uk/image/icon-512x512.png[/img]Para tu archivo, sube en /upload. La página web construye Markdown, HTML y BBCode en el navegador a partir de la URL directa.
No trates los enlaces temporales como assets permanentes en README de larga duración. El uso a largo plazo necesita almacenamiento permanente aprobado en /upload.
Un enlace pulsable no es una imagen incrustada
Ambos ejemplos usan la misma URL de imagen válida. En Markdown, el signo de exclamación convierte un enlace en imagen. Los ejemplos del navegador muestran los elementos equivalentes; el resultado en un foro o documento depende de su editor.
Enlace: el lector abre la imagen
[Mini Tools demo](https://assets.mini-tools.uk/image/icon-512x512.png)El texto se puede pulsar, pero la imagen no aparece en el contenido. Sirve para capturas opcionales o destinos que no permiten imágenes incrustadas.
Imagen: el lector la ve en la página
La imagen aparece directamente si el destino admite imágenes Markdown. En un editor HTML, usa el elemento img mostrado arriba; en BBCode, las etiquetas [img].
Identifica el problema por el resultado visible
- Todo el código aparece como texto
- Comprueba si ves el editor de código o la vista previa. El Markdown dentro de un bloque de código queda literal. Quita los delimitadores del bloque o usa Insertar imagen y pega solo la URL directa.
- Aparece texto pulsable, pero no la imagen
- En Markdown, comprueba el ! antes del corchete. En HTML, a crea un enlace e img muestra una imagen. En BBCode, [url] y [img] también tienen funciones distintas.
- La URL directa funciona, pero falta la imagen en el destino
- Tu navegador puede acceder a la URL. Revisa los ajustes de imágenes remotas y los dominios permitidos en el destino. Volver a subir el mismo archivo no corrige un editor que elimina etiquetas de imagen o bloquea ese dominio.
Si la imagen no se muestra
- Falla el enlace directo: confirma que la URL directa abre sola en una pestaña nueva.
- Formato incorrecto: confirma que el destino acepta el formato pegado (Markdown vs HTML vs BBCode).
- Subida temporal caducada: si usaste retención temporal, comprueba si el periodo terminó.
- El destino bloquea imágenes remotas: algunos sitios bloquean hotlinking o filtran vía CSP/moderación.
FAQ
¿La API devuelve Markdown/HTML/BBCode?
No. La API devuelve campos como success y url. La página web crea los formatos en el navegador.
¿Por qué Markdown sí y HTML no?
El destino puede permitir Markdown de imagen y bloquear HTML en bruto.
¿Puedo reutilizar la URL demo siempre?
Es un recurso del sitio para comparar. Para tu contenido, sube en /upload.
¿Debo cambiar el texto alternativo en la salida Markdown y HTML?
Sí. El texto alternativo por defecto es genérico. Una breve descripción de la imagen ayuda a quienes usan lectores de pantalla y se muestra si la imagen no carga.
Herramientas relacionadas
Crea tu enlace o lee las otras guías.