Passer au contenu principal
Le fichier docs.json vous permet de transformer une collection de fichiers Markdown en un site de documentation personnalisable et facile à parcourir. Ce fichier de configuration obligatoire contrôle le style, la navigation, les intégrations, et bien plus encore. Considérez‑le comme le plan de votre documentation. Les paramètres définis dans 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 s’appliquent 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. 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 des polices pour votre documentation. La police par défaut est Inter.
​
appearance
object
Paramètres du bouton de bascule mode clair/sombre.
​
background
object
Paramètres de couleur et de décoration d’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 de 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 du contenu optimisé par l’IA et des intégrations.

​
Configuration 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 simple
  • 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 remplissage.",
  "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": "Société",
        "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"
    },
    "koala": {
      "publicApiKey": "pk_example_key_123"
    },
    "telemetry": {
      "enabled": true
    },
    "cookies": {
      "key": "example_cookie_key",
      "value": "example_cookie_value"
    }
  },
  "contextual": {
    "options": [
      "copy",
      "view",
      "chatgpt",
      "claude"
    ]
  },
  "errors": {
    "404": {
      "redirect": false,
      "title": "Page 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 encore 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 va créer 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