Quel format copier d'abord ?
L'URL directe pour vérifier le chargement, puis Markdown, HTML ou BBCode.
Formats d'intégration
Utiliser des liens d'image en Markdown, HTML et BBCode
Comparez URL directe, Markdown, HTML et BBCode pour la même image, puis corrigez les affichages manquants.
URL directeMarkdown / HTML / BBCodeMême démo
Choisir le format selon la destination
La plupart des problèmes d’intégration viennent d’un lien valide collé avec la mauvaise syntaxe. Partez de l’endroit où l’image apparaîtra : qu’accepte l’éditeur, et faut-il afficher l’image ou seulement la lier ?
- Messageries, e-mail et tickets de support : collez l’URL directe. Beaucoup affichent un aperçu automatiquement, et le lien fonctionne même si l’aperçu est bloqué.
- GitHub, GitLab, sites de documentation et applications de notes : utilisez le Markdown et remplacez le texte alternatif par défaut par une courte description du contenu, par exemple une page de réglages avec le bouton Enregistrer mis en évidence.
- Éditeurs CMS et pages web écrites à la main : utilisez le HTML pour contrôler la taille. Ajouter width="600" à la balise img évite qu’une grande capture déforme la mise en page.
- Forums sous phpBB, vBulletin, MyBB ou similaires : utilisez le BBCode. Certains forums n’acceptent que des hébergeurs approuvés ; si la balise [img] affiche un cadre vide, publiez l’URL directe comme lien normal.
Même image démo, quatre sorties
Les exemples utilisent une ressource du site pour comparer sans dépendre d'un envoi utilisateur qui expire.
Aperçu réel
Si l'aperçu charge, l'URL directe fonctionne dans un onglet normal.
https://assets.mini-tools.uk/image/icon-512x512.png
URL directe
Coller dans un chat, ticket ou outil qui demande une URL d'image.
https://assets.mini-tools.uk/image/icon-512x512.pngMarkdown
Pour README GitHub, docs et éditeurs Markdown.
HTML
Uniquement si l'éditeur accepte la balise img.
<img src="https://assets.mini-tools.uk/image/icon-512x512.png" alt="Mini Tools demo">BBCode
Uniquement pour les forums qui acceptent les balises [img] classiques.
[img]https://assets.mini-tools.uk/image/icon-512x512.png[/img]Pour vos fichiers, envoyez sur /upload. La page web construit Markdown, HTML et BBCode dans le navigateur à partir de l'URL directe.
Ne traitez pas les liens d'image temporaires comme des assets permanents dans des README durables. L'usage long terme nécessite un stockage permanent approuvé sur /upload.
Un lien cliquable n’est pas une image intégrée
Les deux exemples utilisent la même URL d’image fonctionnelle. En Markdown, le point d’exclamation transforme un lien en image. Les exemples du navigateur montrent les éléments équivalents ; le rendu dans un forum ou un document dépend de son éditeur.
Lien : le lecteur ouvre l’image
[Mini Tools demo](https://assets.mini-tools.uk/image/icon-512x512.png)Le texte est cliquable, mais l’image ne s’affiche pas dans le contenu. Cette option convient aux captures facultatives ou aux sites qui interdisent les images intégrées.
Image : le lecteur la voit dans la page
L’image s’affiche directement si la destination accepte les images Markdown. Dans un éditeur HTML, utilisez l’élément img présenté plus haut ; en BBCode, les balises [img].
Identifier le problème à partir du résultat visible
- Tout le code apparaît comme du texte
- Vérifiez si vous voyez l’éditeur source ou l’aperçu rendu. Le Markdown dans un bloc de code reste littéral. Retirez les délimiteurs du bloc ou utilisez Insérer une image en indiquant uniquement l’URL directe.
- Un texte cliquable apparaît, mais pas l’image
- En Markdown, vérifiez le ! avant le crochet. En HTML, a crée un lien et img affiche une image. En BBCode, [url] et [img] ont aussi des fonctions différentes.
- L’URL directe fonctionne, mais l’image manque à destination
- Votre navigateur accède à l’URL. Vérifiez ensuite les réglages d’images distantes et les domaines autorisés sur la destination. Renvoyer le même fichier ne corrige pas un éditeur qui retire les balises ou bloque le domaine.
Si l'image ne s'affiche pas
- Échec du lien direct : vérifier que l'URL directe s'ouvre seule dans un nouvel onglet.
- Mauvais format : vérifier que la destination accepte le format collé (Markdown vs HTML vs BBCode).
- Envoi temporaire expiré : si conservation temporaire, vérifier si la durée est terminée.
- La destination bloque les images distantes : certains sites bloquent le hotlinking ou filtrent via CSP/modération.
FAQ
L'API renvoie-t-elle Markdown/HTML/BBCode ?
Non. L'API renvoie notamment success et url. La page web construit les formats dans le navigateur.
Pourquoi Markdown marche et pas HTML ?
La destination peut autoriser le Markdown image tout en bloquant le HTML brut.
Puis-je réutiliser l'URL démo pour toujours ?
C'est une ressource du site pour comparer. Pour votre contenu, utilisez /upload.
Faut-il modifier le texte alternatif dans les sorties Markdown et HTML ?
Oui. Le texte alternatif par défaut est générique. Une courte description du contenu aide les utilisateurs de lecteurs d’écran et s’affiche si l’image ne se charge pas.
Outils associés
Créez votre lien ou lisez les autres guides.