Comment créer un lien Markdown ?
Un lien hypertexte Markdown associe un texte cliquable à une destination : [Lire le guide](https://example.com/guide). Les crochets contiennent le texte visible ; les parenthèses, l’adresse.
Pour insérer un lien en Markdown, choisissez « Lien direct », renseignez « Texte du lien » et « URL du lien ou chemin », puis copiez le résultat dans votre document. Le champ « Titre du lien » est facultatif : il ne remplace ni le texte cliquable ni une ancre de section.
Le générateur entoure les destinations de chevrons : [Lire le guide](<https://example.com/guide>). Ils font partie de la syntaxe produite et permettent notamment de délimiter les adresses contenant des parenthèses.
Pourquoi mon lien Markdown ne fonctionne pas ?
Commencez par distinguer trois problèmes : le code reste visible, le lien mène au mauvais endroit, ou la plateforme interprète le Markdown différemment. L’aperçu aide à vérifier le rendu ; il ne confirme pas que la page, le fichier ou le titre existe.
Le lien reste affiché comme du code
Vérifiez que votre éditeur affiche le rendu Markdown et que le lien n’est pas entouré d’accents graves ni placé dans un bloc de code. La syntaxe attendue est [texte](URL), avec les crochets avant les parenthèses. Le mémo Markdown montre aussi les liens de référence et les liens automatiques.
L’URL contient des espaces ou des parenthèses
Le générateur remplace les espaces par %20 et encadre la destination de chevrons. Par exemple, ./docs/guide (final).pdf devient [Guide](<./docs/guide%20(final).pdf>). Des parenthèses dans une URL ne rendent pas systématiquement un lien invalide : leur interprétation dépend aussi du lecteur Markdown.
Le texte du lien contient des crochets
Saisissez le texte tel qu’il doit apparaître. Le générateur échappe les crochets : Guide [PDF] devient Guide \[PDF\] dans le code du lien.
Le lien est cliquable, mais la destination est introuvable
Vérifiez l’adresse, les majuscules du nom de fichier et le chemin depuis le document où vous collerez le lien. Une ancre doit correspondre à un titre existant. Les chemins relatifs et les ancres sont à tester dans le document final, pas depuis cette page.
Ajouter un lien dans un README GitHub
Pour un README, choisissez le type de lien selon sa destination : une page externe, un fichier du dépôt ou une section. Le générateur accepte les URL complètes, les chemins commençant par ./ ou ../, et les ancres commençant par #.
Dans cet outil, saisissez ./docs/installation.md plutôt que docs/installation.md pour indiquer explicitement un chemin relatif. GitHub accepte les deux écritures ; le préfixe ./ permet ici au générateur de reconnaître le chemin.
| Objectif | Destination à saisir | Exemple Markdown |
|---|---|---|
| Ouvrir une documentation externe | https://example.com/guide | [Documentation](https://example.com/guide) |
| Ouvrir un fichier depuis un README à la racine | ./docs/installation.md | [Guide d’installation](./docs/installation.md) |
| Rejoindre un titre du même README | #installation | [Installation](#installation) |
Comment faire un lien vers un titre dans un README GitHub ?
Sur le README affiché dans GitHub, survolez le titre puis utilisez son icône de lien pour récupérer l’ancre exacte. Pour une section du même fichier, saisissez la partie commençant par #. Pour relier plusieurs titres, préparez un sommaire Markdown. Pensez à actualiser les liens si les titres changent. Voir la documentation GitHub sur les liens et les ancres.
Créer un lien masqué sur Discord
Pour partager le règlement de votre serveur avec un texte lisible, utilisez par exemple [Lire le règlement](https://example.com/reglement). Discord appelle ce type de texte cliquable un « lien masqué », comme l’explique son guide de mise en forme.
Dans le générateur, choisissez « Lien direct », saisissez le texte et une URL web complète, puis collez le résultat dans votre message, hors bloc de code. Il n’existe pas de mode Discord dédié : vérifiez le rendu dans Discord et privilégiez un lien simple, sans titre facultatif.
Générer plusieurs liens Markdown pour une documentation
Passez à « Plusieurs liens » pour préparer une liste de ressources. En format « Lien direct », saisissez une ligne par lien, sous la forme texte du lien | URL | titre facultatif. Par exemple : Guide de contribution | ./CONTRIBUTING.md.
Les lignes incomplètes ou les destinations non prises en charge sont signalées avec leur numéro. Seules les lignes valides sont copiées ; les lignes signalées en erreur sont exclues du résultat. Corrigez-les avant de copier l’ensemble pour ne pas oublier de ressource. En format « Lien de référence », un champ d’identifiant s’ajoute entre l’URL et le titre facultatif.
Une liste d’URL seules convient au format « Lien automatique », qui affiche les adresses comme texte cliquable. Pour donner un libellé à chaque lien, utilisez « Lien direct » et fournissez le texte avec l’URL. Cet outil génère des liens ; il n’extrait pas le contenu des pages web.
Quel format choisir pour votre lien ?
Lien direct ou lien de référence Markdown ?
Le lien direct regroupe le texte et l’adresse au même endroit. Le lien de référence sépare le libellé, par exemple [Guide][guide], de sa définition [guide]: <https://example.com/guide>, placée sur une autre ligne. Ce format aide à garder le texte source lisible. Le générateur copie aussi la définition : conservez-la dans le document.
Comment ajouter une infobulle à un lien Markdown ?
Renseignez « Titre du lien ». Le résultat prend la forme [Guide](<https://example.com/guide> "Guide d’installation"). L’affichage de l’infobulle dépend du lecteur Markdown ; gardez les informations essentielles dans le texte visible.
Comment mettre une image cliquable en Markdown ?
Le format « Image » génère une image, sans destination de clic distincte. Pour la rendre cliquable, ajoutez manuellement un lien autour du code obtenu : [](https://example.com/guide). Le chemin de l’image et l’adresse à ouvrir sont deux destinations différentes.
Comment créer un lien mailto en Markdown ?
En « Lien direct », saisissez un texte comme « Contacter l’association » et l’adresse e-mail comme destination. Le générateur ajoute mailto: aux adresses e-mail saisies sans préfixe. En « Lien automatique », le code produit, par exemple <mailto:[email protected]>, inclut le préfixe mailto:, qui apparaît aussi dans le texte affiché.
Peut-on ouvrir un lien Markdown dans un nouvel onglet ?
La syntaxe d’un lien Markdown standard ne propose pas ce réglage. L’aperçu du générateur ouvre les liens dans un nouvel onglet, mais ce comportement n’est pas inclus dans le code copié. Il dépend ensuite du site ou de l’application où le lien est affiché.
Les adresses saisies sont-elles vérifiées en ligne ?
La génération et les contrôles de format se font dans votre navigateur. L’outil ne vérifie pas la disponibilité des destinations. L’ouverture d’un lien contacte le site concerné ; l’aperçu d’une image distante peut également charger cette image depuis son hébergeur.