Passer au contenu principal
Chaque page est un fichier MDX, qui combine du contenu en Markdown avec des composants React pour vous permettre de créer une documentation riche et interactive.

​
Métadonnées de page

Chaque page commence par du frontmatter, les métadonnées YAML délimitées par --- au début d’un fichier. Ces métadonnées définissent l’apparence et le comportement de votre page. Utilisez les métadonnées pour contrôler :
  • Les titres et descriptions des pages
  • Les titres, icônes et tags de la barre latérale
​
title
string
required
Le titre de votre page qui apparaît dans la navigation et les onglets du navigateur.
​
description
string
Une brève description du contenu de cette page. S’affiche sous le titre et améliore le SEO (Search Engine Optimization).
​
sidebarTitle
string
Un titre court qui s’affiche dans la navigation de la barre latérale.
​
icon
string
L’icône à afficher.Options :
​
iconType
string
Le style d’icône Font Awesome. Utilisé uniquement avec les icônes Font Awesome.Options : regular, solid, light, thin, sharp-solid, duotone, brands.
​
tag
string
Un tag qui apparaît à côté du titre de votre page dans la barre latérale.
Example YAML frontmatter
---
title: "À propos du frontmatter"
description: "Le frontmatter correspond aux métadonnées qui contrôlent l'apparence et le comportement de votre page"
sidebarTitle: "Frontmatter"
icon: "book"
tag: "NOUVEAU"
---

​
Mode d’affichage

Déterminez la façon dont votre page s’affiche avec le paramètre mode.

​
Par défaut

Si aucun mode n’est défini, une mise en page standard est utilisée, avec une navigation dans la barre latérale et une table des matières. 
---
title: "Titre de page par défaut"
---

​
Large

Le mode large masque la table des matières. Il est utile pour les pages sans titres ou si vous préférez profiter de l’espace horizontal supplémentaire. Le mode large est disponible pour tous les thèmes. 
---
title: "Titre de page large"
mode: "wide"
---

​
Personnalisé

Le mode personnalisé offre une mise en page minimaliste qui supprime tous les éléments, à l’exception de la barre de navigation supérieure. C’est une toile vierge pour créer des pages d’accueil ou tout autre agencement unique nécessitant un minimum d’éléments de navigation. Le mode personnalisé est disponible pour tous les thèmes. 
---
title: "Titre de page personnalisé"
mode: "custom"
---

​
Frame

Le mode Frame propose une mise en page similaire au mode personnalisé, tout en conservant la navigation de la barre latérale. Ce mode de page permet d’utiliser du HTML personnalisé et des composants tout en préservant l’expérience de navigation par défaut. Le mode Frame est uniquement disponible avec les thèmes Aspen et Almond. 
---
title: "Titre de la page Frame"
mode: "frame"
---

​
Centrage

Le mode Centrage supprime la barre latérale et la table des matières, et centre le contenu. Il est utile pour le journal des modifications ou d’autres pages où vous souhaitez mettre l’accent sur le contenu. Le mode Centrage est disponible pour les thèmes Mint et Linden. 
---
title: "Titre de page centré"
mode: "center"
---

​
Pages d’API

Créez des bacs à sable d’API interactifs en ajoutant une spécification d’API à votre frontmatter, api ou openapi. 
---
openapi: "GET /endpoint"
---
En savoir plus sur la création de documentation d’API. Créez des liens vers des sites externes directement depuis votre navigation à l’aide de la metadata url. 
---
title: "Package npm"
url: "https://www.npmjs.com/package/mint"
---

​
Optimisation pour les moteurs de recherche

La plupart des balises meta SEO sont générées automatiquement. Vous pouvez définir manuellement des balises meta SEO pour améliorer le SEO de votre site, le partage sur les réseaux sociaux et la compatibilité avec les navigateurs.
Les balises meta contenant des deux-points doivent être entourées de guillemets.
---
"twitter:image": "/images/social-preview.jpg"
---
Voir SEO pour la liste complète des options de metadata SEO.

​
Mots-clés de recherche internes

Améliorez la découvrabilité d’une page spécifique dans la recherche intégrée en ajoutant des keywords dans votre metadata. Ces mots-clés n’apparaîtront ni dans le contenu de la page ni dans les résultats de recherche, mais les utilisateurs qui les saisiront verront la page s’afficher parmi les résultats. 
---
keywords: ['configuration', 'installation', 'premiers pas']
---