Hyperliens Markdown

Les liens sont l'un des éléments les plus fondamentaux du contenu web. Markdown fournit plusieurs façons de créer des liens, depuis les liens en ligne simples jusqu'aux liens de référence plus complexes.

Syntaxe de base des liens

La syntaxe de base pour un lien en Markdown est :

[Texte du lien](URL)

Exemples

[Google](https://www.google.com)

Résultat : Google

Liens avec titres

Vous pouvez ajouter un titre à vos liens qui apparaît lorsque les utilisateurs passent la souris dessus :

[Google](https://www.google.com "Moteur de recherche")

Résultat : Google

Liens de référence

Pour les documents plus longs ou quand vous voulez réutiliser des liens, les liens de référence sont très utiles :

Ceci est un [lien de référence][1] et ceci est [un autre][github].

Vous pouvez aussi utiliser [le texte du lien lui-même] comme référence.

[1]: https://www.google.com
[github]: https://github.com
[le texte du lien lui-même]: /

Résultat :

Ceci est un lien de référence et ceci est un autre.

Vous pouvez aussi utiliser le texte du lien lui-même comme référence.

Liens automatiques

Markdown peut automatiquement créer des liens pour les URLs et adresses email :

https://www.google.com
[email protected]

Résultat :

• •
  https://www.google.com
• •
  [email protected]

Liens internes

Liens vers les en-têtes

Vous pouvez créer des liens vers des en-têtes dans le même document :

[Aller à la syntaxe de base](#syntaxe-de-base-des-liens)
[Aller aux exemples](#exemples)

Règles pour les liens d'en-têtes :

• •
  Convertir en minuscules
• •
  Remplacer les espaces par des tirets
• •
  Supprimer les caractères spéciaux

Liens vers d'autres pages

[Hyperliens Markdown](/markdown-guide/hyperlink)

Résultat : Hyperliens Markdown

Meilleures pratiques pour les liens

1. Utiliser un texte de lien descriptif

❌ Ne pas faire ceci :

Cliquez [ici](https://exemple.com) pour visiter notre site web.
Lire plus [ici](https://exemple.com/blog).

✅ Faire ceci à la place :

Visitez notre [site web d'entreprise](https://exemple.com).
Lisez notre [dernier article de blog](https://exemple.com/blog).

2. Garder le texte de lien concis

❌ Trop long :

[Cliquez ici pour visiter notre site web incroyable avec beaucoup de contenu génial](https://exemple.com)

✅ Juste ce qu'il faut :

[Visitez notre site web](https://exemple.com)

3. Utiliser les liens de référence pour la lisibilité

Quand vous avez beaucoup de liens, le style référence garde le contenu lisible :

J'adore utiliser [Markdown][md] pour écrire de la documentation.
Il fonctionne parfaitement avec [GitHub][gh] et [GitLab][gl].
[md]: https://daringfireball.net/projects/markdown/
[gh]: https://github.com
[gl]: https://gitlab.com

Types de liens spéciaux

Liens email

[Envoyez-moi un email](mailto:[email protected])
[Email avec sujet](mailto:[email protected]?subject=Bonjour)

Liens téléphone

[Appelez-nous](tel:+1-555-123-4567)

Conseils d'accessibilité

1. Indiquer les liens externes

Faites savoir aux utilisateurs quand les liens vont vers des sites externes :

[Visitez Google](https://www.google.com) (lien externe)

2. Décrire les types de fichiers

Quand vous liez vers des fichiers, mentionnez le format :

[Télécharger le rapport](rapport.pdf) (PDF, 2MB)

Les liens sont essentiels pour connecter votre contenu au web plus large. Maîtrisez ces techniques et vos documents Markdown seront plus engageants et utiles !

Vous voulez apprendre à créer des listes de tâches ? Consultez notre guide des cases à cocher ensuite.