Fonctionnalités Markdown des docs
Les Docs peuvent utiliser n'importe quelle fonctionnalité Markdown, et ont quelques fonctionnalités de markdown spécifiques aux docs.
#
Markdown frontmatterLes docs Markdown ont leur propre Markdown frontmatter
#
Référencement d'autres documentsSi vous voulez référencer un autre fichier de document, vous pouvez utiliser le nom du document que vous souhaitez référencer. Docusaurus convertira le chemin du fichier pour être le chemin du site web final (et supprimera le .md
).
Par exemple, si vous êtes dans doc2.md
et que vous voulez faire référence à doc1.md
et dossier/doc3.md
:
Je fais référence à un [document](doc1.md). Référence vers un autre [document dans un dossier](dossier/doc3.md).
Le référencement de [document relatif](../doc2.md) fonctionne également.
Un avantage de cette approche est que les liens vers des fichiers externes fonctionneront quand même si vous visualisez le fichier sur GitHub.
Un autre avantage, pour les documents versionnés, est qu'un document versionné sera lié à un autre document de la même version.