Aller au contenu principal
Version : 2.4.0

Liens Markdown

There are two ways of adding a link to another page: through a URL path and a file path.

- [chemin d'accès par l'URL vers un autre document](./installation)
- [chemin d'accès par le fichier vers un autre document](./installation.mdx)

URL paths are unprocessed by Docusaurus, and you can see them as directly rendering to <a href="./installation">, i.e. it will be resolved according to the page's URL location, rather than its file-system location.

If you want to reference another Markdown file included by the same plugin, you could use the relative path of the document you want to link to. Docusaurus' Markdown loader will convert the file path to the target file's URL path (and hence remove the .md extension).

For example, if you are in docs/folder/doc1.md and you want to reference docs/folder/doc2.md, docs/folder/subfolder/doc3.md and docs/otherFolder/doc4.md:

docs/folder/doc1.md
I am referencing a [document](doc2.mdx).

Reference to another [document in a subfolder](subfolder/doc3.mdx).

[Relative document](../otherFolder/doc4.mdx) referencing works as well.

Les chemins de fichiers relatifs sont résolus dans le répertoire du fichier courant. Absolute file paths, on the other hand, are resolved relative to the content root, usually docs/, blog/, or localized ones like i18n/zh-Hans/plugin-content-docs/current.

Les chemins absolus de fichiers peuvent également être relatifs au répertoire du site. However, beware that links that begin with /docs/ or /blog/ are not portable as you would need to manually update them if you create new doc versions or localize them.

You can write [links](/otherFolder/doc4.mdx) relative to the content root (`/docs/`).

You can also write [links](/docs/otherFolder/doc4.mdx) relative to the site directory, but it's not recommended.

Using relative file paths (with .md extensions) instead of relative URL links provides the following benefits:

  • Les liens continueront à fonctionner sur l'interface GitHub et de nombreux éditeurs Markdown
  • Vous pouvez personnaliser les slugs des fichiers sans avoir à mettre à jour tous les liens
  • Le déplacement des fichiers dans les dossiers peut être suivi par votre éditeur, et certains éditeurs peuvent mettre à jour automatiquement les liens du fichier
  • A versioned doc will link to another doc of the exact same version
  • Relative URL links are very likely to break if you update the trailingSlash config
warning

Les références de fichier Markdown ne fonctionnent que lorsque les fichiers source et cible sont traités par la même instance de plugin. Ceci est une limitation technique de notre architecture du traitement Markdown et sera corrigé dans le futur. Si vous liez des fichiers entre des plugins (par exemple, un lien vers une page de doc à partir d'un article du blog), vous devez utiliser des liens URL.