Markdown URL : comment créer un lien cliquable en 6 étapes

On tape une adresse web dans un fichier .md, on enregistre, et au moment du rendu le texte reste… du texte. Pas de bleu, pas de soulignement, rien de cliquable. Le problème n’est presque jamais l’URL elle-même : c’est la façon de l’écrire. Le Markdown attend une syntaxe très précise, deux paires de signes de ponctuation, et il suffit d’en oublier une pour que tout tombe à plat. Bonne nouvelle : une Markdown URL correcte tient en une règle qu’on retient en trente secondes.

Ce tutoriel s’adresse à toute personne qui rédige en Markdown : étudiants qui prennent des notes, blogueurs qui préparent leurs articles avant publication, développeurs qui écrivent une documentation. À la fin, on saura écrire une URL Markdown vers une page web, vers un fichier stocké sur son disque, vers un titre situé plus haut dans le document, et on saura quoi faire quand le chemin contient un espace.

Étape 1 : la syntaxe crochets-parenthèses d’une URL Markdown

Le Markdown est un langage de balisage léger, conçu en 2004, et sa promesse tient en une phrase : le code brut doit rester lisible. Pour les liens, cela donne une écriture en deux blocs collés l’un à l’autre.

1. On ouvre un crochet et on écrit le texte qui sera visible par le lecteur, puis on ferme le crochet.
2. On enchaîne immédiatement, sans espace, sur une parenthèse ouvrante.
3. On colle l’adresse complète de la page, puis on ferme la parenthèse.

Concrètement, une URL Markdown vers un site de référence ressemble à ceci : [site Markdown Guide](https://www.markdownguide.org/). Le lecteur ne verra que « site Markdown Guide », et cliquera dessus pour arriver sur l’adresse.

Pourquoi cet ordre plutôt que l’inverse ? Parce qu’il suit la logique de lecture : on annonce d’abord ce que le lecteur voit, ensuite où on l’emmène. C’est aussi ce qui rend un document Markdown beaucoup plus confortable à relire qu’un fichier HTML, où l’adresse arrive avant le texte et coupe la phrase en deux.

Étape 2 : vérifier que le lien fonctionne vraiment

Écrire la syntaxe ne suffit pas, encore faut-il contrôler le résultat. La plupart des éditeurs Markdown proposent deux affichages : le code source d’un côté, le rendu de style page web de l’autre. C’est dans le rendu qu’on valide son travail.

Trois signes montrent que l’URL Markdown est correcte :

• le texte entre crochets s’affiche seul, sans les crochets ni les parenthèses ;
• il apparaît souligné, dans une couleur différente du reste du paragraphe ;
• en approchant le curseur, l’éditeur révèle l’adresse de destination.

Pour ouvrir le lien, un simple clic ne suffit généralement pas : il faut faire Ctrl + clic, ce qui évite d’être expédié dans le navigateur chaque fois qu’on veut simplement corriger une faute de frappe. Ce comportement varie d’un logiciel à l’autre, donc si le clic seul ne déclenche rien, ce n’est pas forcément un lien cassé.

Étape 3 : pointer vers un fichier local au lieu d’une page web

Voici la bonne nouvelle : il n’y a rien de nouveau à apprendre. Un lien vers un fichier posé sur son disque utilise exactement la même syntaxe qu’un lien vers un site. Seul le contenu des parenthèses change : à la place d’une adresse en https://, on met un chemin de fichier.

Si le fichier visé se trouve dans le même dossier que le document en cours, son nom suffit : [lien](Essai.md). Au Ctrl + clic, le fichier s’ouvre dans une nouvelle fenêtre de l’éditeur, ce qui permet de naviguer entre des notes sans jamais repasser par l’explorateur de fichiers.

Et quand le fichier est ailleurs ? On lui indique la route, soit avec un chemin absolu qui repart de la racine du disque, soit avec un chemin relatif qui part du document courant. Le chemin relatif est en général le plus pratique, car il continue de fonctionner si on déplace tout le dossier. Deux points suivis d’une barre oblique, ../, font remonter d’un cran dans l’arborescence avant de redescendre vers le dossier voulu.

Étape 4 : gérer les espaces et les séparateurs dans le chemin

C’est ici que les problèmes commencent, et ils viennent presque toujours du même endroit : les espaces. Tous les éditeurs Markdown ne les traitent pas de la même manière dans un chemin de fichier. Certains s’en accommodent, d’autres cassent le lien sans prévenir.

La parade s’appelle l’encodage de caractère. On remplace chaque espace par %20, une écriture que tous les moteurs de rendu comprennent. Un chemin comme ../mon dossier/Essai.md devient donc ../mon%20dossier/Essai.md. Ce n’est pas très joli à lire, mais c’est fiable.

Deuxième piège, plus discret : le sens de la barre oblique. Sur certains systèmes on a l’habitude de l’antislash \, et quelques éditeurs l’acceptent. Mais pour rester compatible partout, le conseil est simple : utiliser la barre oblique / systématiquement, quel que soit le système d’exploitation.

Cette même capture montre le cousin direct du lien : l’image. La syntaxe est identique, à un caractère près. On ajoute un point d’exclamation devant le crochet ouvrant, et c’est ce signe, et lui seul, qui indique au rendu qu’il doit afficher le fichier au lieu de proposer un lien vers lui : ![logo Markdown](../assets/markdown_350.png).

Le texte entre crochets devient alors la description textuelle de l’image. Il n’est pas obligatoire, mais on a tout intérêt à le remplir : si l’image est déplacée un jour et que le lien se casse, cette description sera la seule chose qui rappellera ce que l’illustration montrait. Les crochets, eux, restent obligatoires même vides.

Étape 5 : créer un lien interne vers un titre du document

Dans un long document, on veut souvent renvoyer le lecteur vers un chapitre précédent. Le Markdown étendu gère ça avec une variante du lien classique : dans les parenthèses, au lieu d’une adresse, on met un dièse suivi du texte du titre visé. Par exemple [un titre](#Tableaux) conduit à la section « Tableaux ».

Trois règles à respecter scrupuleusement, sinon le lien ne mène nulle part :

1. Un seul dièse, même si le titre visé est un titre de niveau 2 ou 3 écrit avec deux ou trois dièses.
2. Aucun espace entre le dièse et le texte, contrairement à l’écriture d’un titre où l’espace est obligatoire.
3. Le texte doit être strictement identique à celui du titre. Un singulier au lieu d’un pluriel, et la navigation échoue.

Dans le même registre, les notes de bas de page fonctionnent avec un système de référence proche : [^1] à l’endroit du texte, puis [^1]: suivi du contenu de la note, placé plus bas dans le document. Un clic sur le petit numéro amène à la note, un clic sur le signe de retour ramène au point de départ.

Étape 6 : quand l’URL Markdown ne suffit pas, passer au HTML

Le Markdown couvre l’essentiel, mais il a des limites assumées. Impossible, par exemple, de contrôler finement la taille d’une image ou d’appliquer une couleur particulière à un lien. Dans ces cas-là, on peut insérer directement du code HTML et CSS au milieu du Markdown : les éditeurs savent en interpréter une bonne partie.

Une précaution s’impose : il faut toujours laisser une ligne vide entre un bloc Markdown et un bloc HTML. Coller les deux peut fonctionner dans certains cas, mais c’est une source de rendus imprévisibles. Attention aussi à la compatibilité : les éditeurs n’interprètent pas tous les mêmes balises, et une syntaxe qui marche dans un logiciel peut être ignorée dans un autre.

Si le but final est de publier sur le web, le plus sûr reste de laisser un convertisseur faire le travail. Un passage par l’outil Markdown vers HTML transforme chaque [texte](url) en balise <a href> propre, sans oubli ni faute de frappe. Et dans l’autre sens, la conversion HTML vers Markdown permet de récupérer une page existante pour la retravailler en Markdown.

Erreurs fréquentes avec les URL Markdown

• Un espace entre le crochet fermant et la parenthèse ouvrante. C’est l’erreur numéro un. Les deux blocs doivent se toucher, sinon le rendu affiche la ponctuation telle quelle.
• Inverser crochets et parenthèses. Le texte va dans les crochets, l’adresse dans les parenthèses. L’inverse ne produit rien d’exploitable.
• Oublier le point d’exclamation devant une image. On obtient alors un lien cliquable vers le fichier au lieu de l’image affichée.
• Laisser un espace brut dans un chemin de fichier. Le lien peut fonctionner chez vous et casser ailleurs. Le %20 règle la question.
• Recopier approximativement un titre dans un lien interne. La correspondance doit être exacte, à la lettre près.
• Coller du HTML contre du Markdown sans ligne vide. Le rendu devient imprévisible d’un éditeur à l’autre.

Questions fréquentes

Peut-on mettre une URL Markdown vers un fichier qui n’est pas dans le même dossier ?

Oui. Il suffit d’indiquer un chemin, absolu ou relatif. Le chemin relatif part du document en cours et utilise ../ pour remonter d’un niveau dans l’arborescence. C’est l’option la plus robuste si le dossier entier est amené à changer d’emplacement.

Faut-il obligatoirement écrire un texte entre crochets ?

Pour un lien, oui : c’est ce texte qui s’affiche au lecteur. Pour une image, la description entre crochets est facultative et l’image s’affichera même si les crochets sont vides. Il reste conseillé de la remplir, car elle sert de repère quand le fichier a été déplacé et que l’image ne s’affiche plus.

Pourquoi mon lien vers un titre ne mène nulle part ?

Trois causes possibles : plusieurs dièses au lieu d’un seul, un espace glissé après le dièse, ou un écart entre le texte du lien et le texte réel du titre. Ce dernier point est le plus courant, souvent à cause d’un singulier écrit à la place d’un pluriel.

Comment transformer mes liens Markdown en vrai HTML ?

Le Markdown est prévu pour être exporté, notamment vers le HTML et le PDF. Un convertisseur en ligne suffit : il lit la syntaxe crochets-parenthèses et produit les balises correspondantes. Pour un document venu d’un traitement de texte, on peut aussi passer par la conversion Word vers HTML avant de retoucher le code.

Une URL en Markdown, au fond, c’est une seule règle à mémoriser : le texte entre crochets, la destination entre parenthèses, et rien entre les deux. Tout le reste n’est qu’une déclinaison de ce schéma, qu’on vise une page web, un fichier voisin, une image ou un titre situé quelques paragraphes plus haut. Une fois le réflexe pris, écrire des documents richement liés devient nettement plus rapide qu’avec un traitement de texte classique, et le fichier reste lisible même sans logiciel dédié.