DocsDocumentationMdxFrontmatter

Frontmatter

Apprenez à utiliser le frontmatter dans les fichiers MDX.

Le frontmatter est une partie importante d'un fichier MDX. Il sert à définir des informations sur le contenu du fichier, comme le titre, la description, l'auteur, la date de publication, etc.

L'en-tête de métadonnées est défini au début du fichier, entre --- (trois traits d'union) au début et à la fin.

Format

L'en-tête de métadonnées est défini au format clé-valeur, où la clé est le nom de la métadonnée et la valeur est son contenu.

Exemple :

---
title: Document title
description: Document description
---

Selon le type de document (documentation, article de blog, etc.), différentes métadonnées peuvent être utilisées.

Métadonnées pour la documentation

  • title
  • description
  • links
    • source
    • docs
    • blog
    • api

Exemple :

---
title: Document title
description: Document description
links:
  source: https://google.com
  docs: /docs
  blog: /blog
  api: https://google.com
---

Métadonnées pour les articles de blog

  • title
  • excerpt
  • date
  • author_id
  • og_image
  • tags
  • links
    • source
    • docs
    • blog
    • api

Exemple :

---
title: Post title
date: 2024-08-07 22:33:00
excerpt: Post excerpt
author_id: daltonmenezes
og_image: introducing-blogs-og.jpg
links:
  source: https://google.com
  docs: /docs
  blog: /blog
  api: https://google.com
tags: [next.js, open-graph, blog]
---