Passer au contenu principal
Le fichier docs.json vous permet de transformer une collection de fichiers Markdown en un site de documentation navigable et personnalisé. Ce fichier de configuration requis contrôle le style, la navigation, les integrations, et plus encore. Considérez-le comme le plan de votre documentation. Les paramètres de docs.json s’appliquent globalement à toutes les pages.

​
Configuration de votre docs.json

Pour commencer, vous n’avez besoin de spécifier que theme, name, colors.primary et navigation. Les autres champs sont facultatifs et vous pourrez les ajouter à mesure que vos besoins en documentation évoluent. Pour une expérience d’édition optimale, incluez la référence de schéma en haut de votre fichier docs.json. Cela active l’autocomplétion, la validation et des info-bulles utiles dans la plupart des éditeurs de code : 
{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "mint",
  "name": "Votre Documentation",
  "colors": {
    "primary": "#ff0000"
  },
  "navigation": {
    // Votre structure de navigation
  }
  // Le reste de votre configuration
}

​
Référence

Cette section présente la référence complète du fichier docs.json.

​
Personnalisation

​
theme
required
Le thème de mise en page de votre site.L’un des suivants : mint, maple, palm, willow, linden, almond, aspen.Voir Thèmes pour plus d’informations.
​
name
string
required
Le nom de votre projet, de votre organisation ou de votre produit.
​
colors
object
required
Les couleurs utilisées dans votre documentation. Elles sont appliquées différemment selon les thèmes. Si vous ne fournissez qu’une couleur principale, elle sera utilisée pour tous les éléments colorés.
​
description
string
Description de votre site pour le SEO et l’indexation par l’IA.
Définissez votre logo pour les modes clair et sombre.
​
favicon
string or object
Chemin vers votre fichier favicon, y compris l’extension du fichier. Redimensionné automatiquement aux tailles de favicon appropriées. Peut être un fichier unique ou des fichiers distincts pour les modes clair et sombre. Exemple : /favicon.png
​
thumbnails
object
Personnalisation des vignettes pour les réseaux sociaux et les aperçus de page.
​
styling
object
Configurations de style visuel.
​
icons
object
Paramètres de la bibliothèque d’icônes.
​
fonts
object
Configuration de la police pour les titres de votre documentation. La police par défaut varie selon le thème.
​
appearance
object
Paramètres de l’interrupteur de mode clair/sombre.
​
background
object
Paramètres de couleur et de décoration de l’arrière-plan.

​
Structure

​
navbar
object
Éléments de la barre de navigation pointant vers des liens externes.
​
navigation
object
required
La structure de navigation de votre contenu.
​
interaction
object
Paramètres d’interaction utilisateur pour les éléments de navigation.
​
footer
object
Contenu du pied de page et liens vers les réseaux sociaux.
​
banner
object
Bannière sur l’ensemble du site affichée en haut des pages.
​
redirects
array of object
Redirections pour les pages déplacées, renommées ou supprimées.
​
contextual
object
Menu contextuel pour le contenu optimisé par l’IA et les intégrations.

​
Configurations d’API

​
api
object
Paramètres de la documentation d’API et du bac à sable interactif.
​
seo
object
Configurations d’indexation pour le SEO.
​
search
object
Paramètres d’affichage de la recherche.

​
Intégrations

​
Intégrations
object
Intégrations tierces.

​
Erreurs

​
errors
object
Paramètres de gestion des erreurs.

​
Exemples

  • Exemple de base
  • Exemple d’API interactif
  • Exemple multilingue
docs.json
{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "maple",
  "name": "Example Co.",
  "description": "Example Co. est une entreprise qui fournit du contenu d'exemple et du texte de substitution.",
  "colors": {
    "primary": "#3B82F6",
    "light": "#F8FAFC",
    "dark": "#0F172A"
  },
  "navigation": {
    "dropdowns": [
      {
        "dropdown": "Documentation",
        "icon": "book",
        "description": "Comment utiliser le produit Example Co.",
        "groups": [
          {
            "group": "Prise en main",
            "pages": [
              "index",
              "quickstart"
            ]
          },
          {
            "group": "Personnalisation",
            "pages": [
              "settings",
              "users",
              "features"
            ]
          },
          {
            "group": "Facturation",
            "pages": [
              "billing/overview",
              "billing/payments",
              "billing/subscriptions"
            ]
          }
        ]
      },
      {
        "dropdown": "Journal des modifications",
        "icon": "history",
        "description": "Mises à jour et modifications",
        "pages": [
          "changelog"
        ]
      }
    ]
  },
  "logo": {
    "light": "/logo-light.svg",
    "dark": "/logo-dark.svg",
    "href": "https://example.com"
  },
  "navbar": {
    "links": [
      {
        "label": "Communauté",
        "href": "https://example.com/community"
      }
    ],
    "primary": {
      "type": "button",
      "label": "Commencer",
      "href": "https://example.com/start"
    }
  },
  "footer": {
    "socials": {
      "x": "https://x.com/example",
      "linkedin": "https://www.linkedin.com/company/example",
      "github": "https://github.com/example",
      "slack": "https://example.com/community"
    },
    "links": [
      {
        "header": "Ressources",
        "items": [
          {
            "label": "Clients",
            "href": "https://example.com/customers"
          },
          {
            "label": "Entreprise",
            "href": "https://example.com/enterprise"
          },
          {
            "label": "Demander un aperçu",
            "href": "https://example.com/preview"
          }
        ]
      },
      {
        "header": "Entreprise",
        "items": [
          {
            "label": "Carrières",
            "href": "https://example.com/careers"
          },
          {
            "label": "Blog",
            "href": "https://example.com/blog"
          },
          {
            "label": "Politique de confidentialité",
            "href": "https://example.com/legal/privacy"
          }
        ]
      }
    ]
  },
  "integrations": {
    "ga4": {
      "measurementId": "G-XXXXXXXXXX"
    },
    "telemetry": {
      "enabled": true
    },
    "cookies": {
      "key": "example_cookie_key",
      "value": "example_cookie_value"
    }
  },
  "contextual": {
    "options": [
      "copy",
      "view",
      "chatgpt",
      "claude"
    ]
  },
  "errors": {
    "404": {
      "redirect": false,
      "title": "Introuvable",
      "description": "Qu'est-il donc **arrivé** à cette _page_ ?"
    }
  }
}

​
Mise à niveau depuis mint.json

Si votre projet de documentation utilise le fichier mint.json obsolète, suivez ces étapes pour passer à docs.json.
1

Installer ou mettre à jour l’interface en ligne de commande (CLI)

Si vous n’avez pas installé la CLI, installez-la maintenant :
npm i -g mint
Si vous avez déjà installé la CLI, assurez-vous qu’elle est à jour :
mint update
2

Créer votre fichier docs.json

Dans votre référentiel de documentation, exécutez :
mint upgrade
Cette commande crée un fichier docs.json à partir de votre mint.json existant. Passez en revue le fichier généré pour vous assurer que tous les paramètres sont corrects.
3

Supprimer votre fichier mint.json

Après avoir vérifié que votre docs.json est correctement configuré, vous pouvez supprimer en toute sécurité votre ancien fichier mint.json.
⌘I