Passer au contenu principal
Le fichier .mintignore vous permet d’exclure des fichiers et des répertoires spécifiques d’être traités et publiés sur votre site de documentation. Utilisez .mintignore pour conserver les brouillons, les notes internes et les fichiers source en dehors de votre documentation publique tout en les gardant dans votre référentiel.

Créer un fichier .mintignore

Créez un fichier .mintignore à la racine de votre répertoire de documentation. Ce fichier utilise la même syntaxe de motifs que .gitignore.
.mintignore
# Exclure les documents brouillons
drafts/
*.draft.mdx

# Exclure la documentation interne
internal/

# Exclure des fichiers spécifiques
private-notes.md
Lorsque Mintlify génère votre documentation, il lit le fichier .mintignore et exclut de la génération tous les fichiers ou répertoires correspondants. Fichiers exclus :
  • n’apparaissent pas dans votre documentation publiée ;
  • ne sont pas indexés pour la recherche ;
  • ne sont pas accessibles aux visiteurs ;
  • sont ignorés par les contrôles de liens rompus. Les liens qui pointent vers des fichiers ignorés sont considérés comme rompus.

Motifs ignorés par défaut

Mintlify ignore automatiquement les répertoires suivants sans nécessiter de configuration :
  • .git
  • .github
  • .claude
  • .agents
  • .idea
  • node_modules
Vous n’avez pas besoin de les ajouter à votre fichier .mintignore.
Contrairement aux pages masquées, les fichiers exclus par .mintignore sont entièrement retirés de votre site et ne sont pas accessibles via leur URL.

Syntaxe des motifs

Le fichier .mintignore utilise la même syntaxe que .gitignore. Voici quelques motifs courants :
MotifDescription
drafts/Exclut l’intégralité du répertoire drafts
*.draft.mdxExclut tous les fichiers se terminant par .draft.mdx
private-notes.mdExclut un fichier spécifique
**/internal/**Exclut tout répertoire internal, quel que soit son niveau
!important.mdxAnnule un motif précédent (inclut le fichier)