Liens Markdown

Les liens sont des éléments clés qui rendent les documents Markdown interactifs.

Maîtriser la syntaxe des liens vous permet de créer des documents riches et faciles à parcourir.

L'utilisation des liens est la suivante :

[link name](link URL)
[link text](link URL "optional title")

Ou :

<link URL>

Un lien simple :

这是一个链接 [Example](https://www.example.com)

Le résultat s'affiche comme suit :

Utiliser directement l'adresse du lien :

<https://www.example.com>

Le résultat s'affiche comme suit :

Définir un titre facultatif :

这是一个链接 [Example](https://www.example.com)
欢迎访问 [GitHub](https://github.com) 官网
这是 [百度搜索](https://www.baidu.com "百度一下，你就知道")

Le résultat s'affiche comme suit :

Le but du titre du lien :

  • Affiche des informations d'infobulle lorsque la souris survole le lien
  • Utile pour l'optimisation pour les moteurs de recherche et l'accessibilité
  • Le texte du titre peut être placé entre guillemets doubles, guillemets simples ou parenthèses

Lien e-mail :

markdown联系我：[发送邮件](mailto:[email protected])
电话联系：[拨打电话](tel:+86-138-0013-8000)

Liens de référence

Les liens de style référence séparent la définition du lien de son utilisation, ce qui rend les documents plus clairs et convient particulièrement aux documents longs ou aux situations où le même lien doit être référencé plusieurs fois.

Syntaxe de base :

markdown[链接文字][参考标签]

[参考标签]: URL "可选标题"

Nous pouvons définir un lien via une variable, l'affectation de la variable étant effectuée à la fin du document :

这个链接用 1 作为网址变量 [Google][1]
这个链接用 example 作为网址变量 [Example][example]
然后在文档的结尾为变量赋值（网址）

  [1]: http://www.google.com/
  [example]: http://www.example.com/

Le résultat s'affiche comme suit :

Syntaxe simplifiée :

Lorsque le libellé de référence est identique au texte du lien, les seconds crochets peuvent être omis :

markdown 我喜欢使用 [GitHub][] 来管理代码。

[GitHub]: https://github.com

Avantages des liens de référence :

  • Le corps du document est plus clair et n'est pas interrompu par de longues URL
  • Facilite la gestion et la mise à jour unifiées des liens
  • Le même lien peut être réutilisé, ce qui évite les définitions en double
  • Les définitions de liens peuvent être placées n'importe où dans le document (généralement à la fin)

Conseils d'organisation :

markdown# 学习资源推荐

## 在线教程
- [MDN Web Docs][mdn] - 权威的 Web 技术文档
- [EXAMPLE][rnb] - 适合初学者的教程网站
- [freeCodeCamp][fcc] - 免费的编程学习平台

## 代码托管
- [GitHub][github] - 最受欢迎的代码托管服务
- [GitLab][gitlab] - 企业级的代码管理平台

<!-- 链接定义区域 -->
[mdn]: https://developer.mozilla.org/
[rnb]: https://www.example.com/
[fcc]: https://www.freecodecamp.org/
[github]: https://github.com/
[gitlab]: https://gitlab.com/

Reconnaissance automatique des liens

Les analyseurs Markdown modernes prennent généralement en charge la reconnaissance automatique des URL et des adresses e-mail :

Reconnaissance automatique des URL :

markdown直接输入网址：https://www.example.com
用尖括号包围：<https://www.example.com>

Reconnaissance automatique des e-mails :

markdown联系邮箱：[email protected]
或者：<[email protected]>

Notes :

  • La fonctionnalité de reconnaissance automatique dépend de l'analyseur Markdown spécifique
  • Pour garantir la compatibilité, il est recommandé d'utiliser la syntaxe de lien standard
  • Certains caractères spéciaux peuvent affecter la reconnaissance automatique

Utilisation des liens d'ancrage

Les liens d'ancrage servent à sauter à l'intérieur d'un même document et sont particulièrement adaptés à la navigation dans les documents longs :

Aller au titre :

## Table of Contents
- [Chapter 1: Introduction](#第一章介绍)
- [Chapter 2: Installation](#第二章安装)
- [Chapter 3: Usage](#第三章使用方法)

# Chapter 1: Introduction
This is the introduction content...

# Chapter 2: Installation
These are the installation instructions...

# Chapter 3: Usage
These are the usage instructions...

Règles d'ancrage :

  • Les titres génèrent automatiquement des ancres
  • Le nom de l'ancre est généralement la forme en minuscules du titre
  • Les espaces sont remplacés par des tirets
  • Les caractères spéciaux sont supprimés

Création manuelle d'ancres :

<a id="custom-anchor"></a>
## 自定义锚点位置

[跳转到自定义位置](#custom-anchor)

Lien de retour en haut :

[Back to top](#)
Autres extensions