Mintlify est une plateforme hébergée pour la documentation technique. Vous écrivez des fichiers MDX dans un dépôt et vous recevez en retour un site avec recherche, un playground d'API interactif et un ensemble de sorties destinées aux assistants de code. Le moteur est fermé et couvert par la licence Elastic 2.0, l'outil en ligne de commande est en version 4.2.816, et le plan gratuit s'appelle Starter et donne cinq sièges d'éditeur.
Ce que fait réellement Mintlify
Le modèle de fonctionnement est simple, et c'est là qu'il diffère des générateurs de sites statiques classiques : le dépôt de contenu est la source de vérité, tandis que le build et l'hébergement appartiennent au fournisseur. Le répertoire contient des fichiers .md ou .mdx, un seul fichier de configuration docs.json et éventuellement des spécifications OpenAPI. Une fois le dépôt connecté, chaque commit fusionné déclenche un déploiement côté Mintlify.
Les pages peuvent être du Markdown simple, mais MDX ouvre l'accès à des composants que le Markdown simple n'a pas : cartes, accordéons, cadres, champs décrivant les réponses d'API. La documentation suggère explicitement de commencer une migration depuis une autre plateforme avec des fichiers .md et de passer à MDX plus tard, une fois que le contenu fonctionne déjà.
Le deuxième pilier est la référence d'API. Vous pointez vers un fichier OpenAPI ou AsyncAPI et la plateforme génère à partir de lui des pages de méthodes avec un playground dans lequel le lecteur envoie une requête directement depuis le navigateur. Le playground d'API est disponible dès le plan Starter, de même qu'un domaine personnalisé, l'éditeur web, l'authentification et un serveur MCP hébergé.
Le troisième pilier, et le plus intéressant pour cette collection, est l'ensemble de sorties pour les modèles de langage. Mintlify héberge un fichier llms.txt, un fichier llms-full.txt, une version Markdown de chaque page à la même adresse avec .md ajouté, un serveur MCP sur le contenu et un menu contextuel qui ouvre la page courante dans un assistant choisi.
Ce que Mintlify ne fait pas mérite aussi une réponse franche. Ce n'est pas un moteur que l'on peut faire tourner sur son propre serveur avec un plan gratuit. Ce n'est pas un système de gestion de contenu pour une équipe éditoriale non technique, même si l'éditeur web va dans cette direction. Il ne remplacera pas un blog ou un site marketing, car toute la mise en page est construite autour de la navigation de documentation. Il ne vérifiera pas pour vous si le comportement décrit dans le texte correspond toujours au code, car les pages et la bibliothèque vivent dans des dépôts séparés sans rien qui les lie automatiquement.
Version, licence et un emplacement vide sur GitHub
Le paquet mint du registre npm est en version 4.2.816. C'est une enveloppe mince : il déclare exactement une dépendance, @mintlify/cli en version 4.0.1419, et le champ engines exige Node 18 ou plus récent. Le paquet mintlify est publié en parallèle sous le même numéro et contient le même outil.
La licence est l'endroit où trois sources devraient concorder et où l'une d'elles n'existe tout simplement pas. Le champ license du registre npm indique Elastic-2.0. L'archive décompressée contient un fichier LICENSE avec le texte complet de l'Elastic License 2.0 et une mention de copyright de Mintlify, Inc. datée de 2022. La troisième source, le fichier de licence du dépôt, ne peut pas être vérifiée : le champ repository du manifeste pointe vers github.com/mintlify/mint, et l'API de GitHub répond à cette adresse par un message d'introuvable. Le code source du moteur n'est pas public.
Cette distinction est facile à manquer, car l'organisation mintlify a plusieurs dépôts sous licence MIT sur GitHub. Le dépôt mintlify/starter, le squelette d'un nouveau projet, a environ 1,9 mille étoiles. Le dépôt mintlify/docs, avec le contenu de la documentation officielle, a environ 435 étoiles, et mintlify/components environ 114. Les trois sont ouverts, aucun n'est archivé, et aucun ne contient le moteur. Le template et le contenu sont ouverts ; le programme qui les rend est fermé.
L'Elastic License 2.0 elle-même est une licence à code source disponible plutôt qu'ouverte au sens de l'OSI, et sa limitation centrale est énoncée sans détour : vous ne pouvez pas fournir le logiciel à des tiers comme un service hébergé ou managé qui donne aux utilisateurs accès à un ensemble substantiel de ses fonctions. Pour une équipe qui construit simplement sa propre documentation, cette clause n'a aucun poids pratique. Elle compte pour quiconque voudrait bâtir un service concurrent sur ce moteur, et pour un service juridique qui tient une liste des licences de dépendances et traite tout ce qui dépasse MIT, Apache et BSD comme un point à examiner séparément.
Un fil de plus appartient au portrait de l'entreprise. En mars 2026, Mintlify a racheté Helicone, une couche d'observabilité pour les appels aux modèles de langage. Le produit est passé en mode maintenance, ce que nous décrivons en détail dans l'article sur Helicone, et les équipes qui cherchent aujourd'hui une alternative aboutissent généralement à Langfuse. Pour juger Mintlify lui-même, c'est une information sur la direction : l'entreprise rachète des pièces du puzzle autour du travail avec les modèles et les consolide, et les produits rachetés ne continuent pas toujours à recevoir du développement. Si vous construisez sur quelque chose que le fournisseur peut basculer en mode maintenance, gardez un plan de sortie. Avec la documentation, le plan de sortie est peu coûteux, car le contenu est constitué de fichiers Markdown ordinaires dans votre propre dépôt.
docs.json et structure du projet
Toute la configuration tient dans un seul fichier docs.json à la racine du projet. La forme minimale exige quatre champs ; le reste est optionnel.
{
"$schema": "https://mintlify.com/docs.json",
"theme": "mint",
"name": "Acme Docs",
"colors": {
"primary": "#1a73e8"
},
"navigation": {
"groups": [
{
"group": "Get started",
"pages": ["index", "quickstart"]
},
{
"group": "Guides",
"pages": ["guides/first-steps", "guides/advanced"]
}
]
}
}La référence $schema n'est pas décorative. Elle active l'autocomplétion et la validation dans l'éditeur, et avec un fichier qui atteint plusieurs centaines de lignes au bout de six mois, c'est la différence entre une correction dans l'éditeur et une erreur découverte au moment du déploiement.
À mesure que le fichier grossit, vous pouvez le découper avec le champ $ref. Vous insérez $ref avec un chemin relatif n'importe où dans la configuration et Mintlify remplace l'objet par le contenu du fichier référencé au moment du build. Les règles sont strictes, et il est bon qu'elles soient documentées : les chemins doivent être relatifs et rester à l'intérieur de la racine du projet, donc ../../outside est rejeté, les références circulaires se terminent par une erreur de build, et les clés voisines dans le même bloc remplacent ce qui venait du fichier référencé par $ref.
Chaque page commence par un bloc YAML. Les champs sont optionnels, mais quelques-uns décident de comportements difficiles à reconstituer de mémoire plus tard.
---
title: "Setting rate limits"
description: "How to configure request limits for an API key"
sidebarTitle: "Rate limits"
icon: "gauge"
tag: "beta"
noindex: false
searchable: true
---
Page content in MDX with platform components.Le champ hidden: true retire une page de la navigation et implique noindex: true. La documentation avertit que définir hidden: false produit un comportement indéfini, donc le champ vaut soit true, soit il est absent du fichier. Les champs noindex et searchable se confondent facilement : le premier écarte une page de la recherche du site, du sitemap, de l'indexation par les moteurs de recherche et du contexte des assistants, tandis que le second ne l'exclut que de la recherche du site et du contexte des assistants, en la laissant visible pour les moteurs de recherche externes.
Une documentation lisible par les modèles
C'est le vrai avantage de la plateforme, et il vaut la peine de le diviser en quatre mécanismes distincts, car on les confond.
Le premier est llms.txt, un fichier qui suit le standard décrit sur llmstxt.org, hébergé automatiquement à la racine du site et en plus à /.well-known/llms.txt. Il contient la liste de chaque page sous forme de liens Markdown avec des résumés, donc un assistant lit d'abord l'index et ne récupère qu'ensuite ce dont il a besoin. Une version personnalisée du fichier est possible, mais celle par défaut se met à jour toute seule.
Le deuxième est llms-full.txt, tout le contenu de la documentation collé dans un seul fichier. L'échelle fait ici la différence et il est facile de la vérifier sur la documentation de Mintlify elle-même : llms.txt y pèse environ 56 kilo-octets, tandis que llms-full.txt pèse environ 1,5 mégaoctet. Le premier tient dans le contexte d'un modèle sans y réfléchir ; le second demande un découpage ou une recherche, et le remettre en entier à un assistant a rarement du sens.
Le troisième mécanisme est la version Markdown d'une seule page. Vous ajoutez .md à l'adresse et vous recevez la source au lieu du HTML. Cet article existe en partie grâce à cela : l'adresse de la documentation avec .md ajouté renvoie du Markdown propre que l'on peut lire sans se battre contre les balises de mise en page, les scripts et les styles. Pour un assistant de code, c'est la différence entre quelques milliers de tokens de contenu et quelques dizaines de milliers de tokens d'emballage.
Le quatrième est le menu contextuel, piloté par le champ contextual de docs.json. Les options s'activent par identifiant, et leur ordre dans la liste fixe leur ordre dans le menu.
{
"contextual": {
"options": [
"copy",
"view",
"assistant",
"chatgpt",
"claude",
"perplexity",
"mcp",
"cursor",
"vscode",
"download-spec"
],
"display": "toc"
}
}L'identifiant copy copie la page en Markdown, view l'ouvre en Markdown, claude démarre une conversation dans Claude avec la page courante comme contexte, cursor installe votre serveur MCP dans Cursor, et download-spec télécharge la spécification OpenAPI et n'apparaît que sur les pages de référence d'API. L'option download-pdf existe mais est indiquée comme disponible sur les plans Enterprise. Régler display sur toc déplace le menu de l'en-tête de la page vers la barre latérale de la table des matières.
Ligne de commande : aperçu, validation et mint score
L'outil s'installe globalement ou s'exécute via npx, et le jeu de commandes est plus large que le nom ne le laisse penser.
# installation and local preview, default port 3000
npm install -g mint
mint dev --port 4000 --no-open
# skip OpenAPI processing when the specification is large
mint dev --disable-openapi
# strict-mode build, non-zero exit code on warnings
mint validate
# separate content checks
mint broken-links
mint a11y
mint format
# export the site into a self-contained archive
mint export --output docs-offline.zip
# score the site's readiness for agents
mint score docs.example.com --format jsonLa commande mint validate remplace l'ancienne mint openapi-check, aujourd'hui dépréciée, et valide aussi les spécifications référencées depuis docs.json, donc c'est celle qui a sa place dans un pipeline d'intégration continue. L'option --groups permet de simuler l'appartenance à des groupes d'utilisateurs, ce qui est la seule façon sensée de voir du contenu protégé par authentification sans se connecter à un vrai compte.
mint score est à part : il interroge une adresse publique et émet un score pondéré de préparation pour les agents. Les vérifications ont des noms lisibles et montrent ce que le fournisseur juge important : llmsTxtExists, llmsTxtValid, llmsTxtSize, llmsTxtLinksResolve, llmsTxtFullExists, skillMd, contentNegotiationMarkdown, contentNegotiationPlaintext, mcpServerDiscoverable, mcpToolCount, openApiSpec, robotsTxtAllowsAI, sitemapExists, structuredData et responseLatency. Les vérifications dépendantes échouent avec celle dont elles dépendent, donc un llms.txt manquant fait tomber plusieurs entrées à la fois. La commande exige de se connecter avec mint login, mais accepte n'importe quelle adresse, donc vous pouvez aussi noter la documentation de quelqu'un d'autre.
Il y a aussi mint index, qui installe un serveur MCP hébergé qui indexe le contenu de plusieurs sites construits sur Mintlify et le connecte à un client : --claude, --cursor, --vscode, --codex, --opencode, --windsurf ou --zed. C'est un serveur différent de celui qui décrit votre propre documentation, et les confondre mène à la surprise que l'agent ne voie pas vos pages.
Tarifs, plan gratuit et auto-hébergement
La page de tarification montre trois plans. Starter coûte zéro dollar par mois et donne cinq sièges d'éditeur, la plateforme complète, un domaine personnalisé, l'éditeur web, l'authentification, un serveur MCP et le playground d'API. Pour un plan gratuit, c'est beaucoup, car des éléments généralement réservés aux paliers payants, à savoir un domaine personnalisé et un serveur MCP, sont inclus dès le départ.
Pro est affiché à 450 dollars par mois, avec un interrupteur au-dessus du prix entre facturation mensuelle et annuelle, et un seul chiffre a pu être lu dans la page brute. Considérez-le comme le chiffre affiché par défaut et confirmez l'autre auprès du fournisseur avant de signer quoi que ce soit. Le plan ajoute des sièges d'éditeur illimités, un agent, un assistant, des automatisations, des déploiements de prévisualisation et des API d'administration. Cela veut dire que l'assistant qui répond aux questions des lecteurs dans la documentation est une fonction payante plutôt qu'une partie du plan gratuit, et si cet assistant est la raison pour laquelle vous choisissez Mintlify, Starter est immédiatement écarté.
Enterprise a un prix sur demande et couvre SSO, SCIM, le contrôle d'accès par rôles, un accord de niveau de service de performance, des analyses avancées et une aide à la migration. L'auto-hébergement apparaît aussi à ce palier. La documentation est honnête ici et dit clairement que ce n'est pas une installation en libre-service mais un périmètre convenu avec l'équipe commerciale du fournisseur, généralement mesuré en semaines. Le déploiement passe par une application AWS CDK ou un chart Helm sur AKS, GKE, OKE, OpenShift ou n'importe quel Kubernetes. Les limites sont décrites tout aussi clairement : les fonctions liées aux modèles sont livrées désactivées jusqu'à ce que votre équipe de sécurité les approuve, les intégrations qui dépendent des services cloud de Mintlify ne fonctionnent tout simplement pas, les mises à jour arrivent sous forme de versions numérotées que vous déployez vous-même, et vous branchez votre propre supervision.
La page de tarification mentionne aussi des crédits pour le premier mois, mais n'indique pas leur nombre dans le contenu de la page, donc nous ne l'indiquons pas non plus. Si vous construisez un budget, c'est la première question à poser à l'équipe commerciale.
Le déploiement n'a pas à passer par un domaine séparé. Mintlify documente la publication de la documentation sous un sous-chemin d'un site existant, par exemple à une adresse qui se termine par /docs, via des règles de réécriture côté serveur. Si le site principal tourne sur Next.js, cela se résume à une seule entrée dans la configuration des rewrites.
Mintlify face aux alternatives
Choisir entre une plateforme hébergée et un générateur que l'on exploite soi-même revient à savoir si l'on préfère payer avec de l'argent ou avec le temps de l'équipe. Voici des chiffres vérifiés dans les registres de paquets et sur les pages de tarification des fournisseurs.
| Critère | Mintlify | Docusaurus | Starlight | GitBook | ReadMe |
|---|---|---|---|---|---|
| Moteur | fermé, Elastic 2.0 | ouvert, MIT | ouvert, MIT | fermé | fermé |
| Hébergement | fournisseur, le vôtre à partir d'Enterprise | le vôtre | le vôtre | fournisseur | fournisseur |
| Version | mint 4.2.816 | 3.10.2 | 0.41.7 | service sans numéro | service sans numéro |
| Plan gratuit | Starter 0 USD, 5 sièges | sans objet | sans objet | Free 0 USD par site | Starter 0 USD |
| Premier plan payant | 450 USD par mois | sans objet | sans objet | 65 USD par site plus 12 USD par utilisateur | 250 USD par mois en facturation annuelle |
| llms.txt hébergé automatiquement | oui | pas dans le cœur | pas dans le cœur | indiqué comme partie du plan Free | oui, sur le plan Starter |
Starlight est un thème pour Astro, donc il arrive avec tout cet environnement de build. Docusaurus diffère de Mintlify surtout par le fait que son moteur est ouvert et tourne sur votre propre serveur, et que le versionnement de la documentation et les traductions sont dans le cœur. Deux inconvénients valent d'être connus : il n'y a pas de recherche dans le cœur et la voie standard passe par Algolia comme service externe, gratuit uniquement pour la documentation technique publique une fois la demande approuvée, et tout le site est une application React, donc une équipe sans React hérite d'un écosystème qu'elle n'a pas demandé. Docusaurus et Starlight ne coûtent rien d'autre que du temps : la recherche, le déploiement, le playground d'API et les sorties pour les modèles sont assemblés par vous à partir de plugins et de services externes. Pour une équipe de deux personnes, c'est généralement quelques jours de travail plus une petite taxe de maintenance continue. Pour une documentation qui fait partie du produit et change tous les jours, l'arithmétique commence à favoriser une plateforme hébergée.
Erreurs courantes
La première erreur est de traiter Mintlify comme un projet ouvert d'après les dépôts visibles sur GitHub. Ce qui est ouvert sous MIT, ce sont le template de démarrage, le contenu de la documentation et la bibliothèque de composants. Le moteur est fermé, publié sous Elastic 2.0, et le dépôt référencé dans le manifeste du paquet ne répond pas publiquement.
La deuxième est de planifier un déploiement sur le plan Starter et de découvrir à mi-chemin que l'assistant, l'agent et les automatisations ne commencent qu'à Pro. Lisez la liste des fonctions du plan avant de migrer le contenu, pas après.
La troisième est hidden: false dans le bloc YAML d'une page. La documentation décrit ce réglage comme un comportement indéfini. Pour afficher à nouveau une page, vous supprimez le champ entier.
La quatrième est de confondre noindex et searchable. Une page avec searchable: false atterrit quand même dans le sitemap et dans les moteurs de recherche externes, donc ce n'est pas une façon de cacher quoi que ce soit.
La cinquième est de laisser mint validate hors du pipeline d'intégration continue. Sans lui, une spécification OpenAPI cassée ou un lien mort arrive en production, car l'aperçu local est plus indulgent qu'un build en mode strict.
La sixième est de donner à un assistant tout le llms-full.txt. Pour une documentation de la taille de celle de Mintlify, c'est un mégaoctet et demi de texte. La bonne voie est l'index, puis les pages individuelles avec .md ajouté, ou le serveur MCP.
La septième est de découper docs.json avec des chemins $ref qui sortent du répertoire du projet. Remonter dans l'arborescence est bloqué, et une référence circulaire se termine par une erreur de build.
FAQ
Mintlify est-il un logiciel open source ?
Non. Le paquet mint du registre npm porte la licence Elastic 2.0, et le même texte de licence se trouve dans l'archive publiée. L'Elastic License 2.0 est à code source disponible plutôt qu'ouverte, et elle interdit de fournir le logiciel comme service hébergé concurrent. Les dépôts mintlify/starter, mintlify/docs et mintlify/components sont sous licence MIT, mais ils contiennent le template, le contenu et les composants, pas le moteur.
Que donne le plan gratuit ?
Le plan Starter coûte zéro dollar et couvre cinq sièges d'éditeur, un domaine personnalisé, l'éditeur web, l'authentification, un serveur MCP hébergé et le playground d'API. En dehors de lui se trouvent l'agent, l'assistant qui répond aux lecteurs, les automatisations, les déploiements de prévisualisation et les API d'administration, qui commencent au plan Pro.
Faut-il écrire en MDX ?
Non. Les pages peuvent être de simples fichiers .md, et la documentation elle-même recommande cette voie lors d'une migration depuis une autre plateforme pour que le contenu passe d'abord. MDX ne devient nécessaire que quand vous voulez des composants de la plateforme comme des cartes, des accordéons ou des champs décrivant les réponses d'API.
Comment la documentation parvient-elle à un assistant de code ?
Par quatre voies. Le fichier llms.txt à la racine du site fournit un index des pages, llms-full.txt fournit tout le contenu en un seul fichier, ajouter .md à une adresse renvoie la source d'une seule page, et le serveur MCP hébergé permet à un agent de chercher dans le contenu avec un outil. Le menu contextuel ajoute des boutons qui ouvrent la page courante dans un assistant choisi.
Puis-je faire tourner Mintlify sur ma propre infrastructure ?
Seulement sur le plan Enterprise et seulement comme périmètre de déploiement convenu, pas comme installation en libre-service. Les voies disponibles sont une application AWS CDK ou un chart Helm sur AKS, GKE, OKE, OpenShift ou n'importe quel Kubernetes. Les fonctions liées aux modèles sont désactivées par défaut dans cette configuration, et les intégrations qui dépendent du cloud du fournisseur ne fonctionnent pas.
Qu'a fait Mintlify d'Helicone ?
Il a racheté l'entreprise en mars 2026 et a fait passer le produit en mode maintenance, c'est-à-dire sans nouvelles fonctions. L'édition auto-hébergée reste sous Apache 2.0 et le dépôt Helicone/helicone n'est pas archivé. Nous traitons les détails séparément dans l'article sur Helicone.
Vous trouverez la configuration et la liste complète des champs dans la documentation de Mintlify, les tarifs sur la page des plans, et le squelette d'un nouveau projet dans le dépôt starter.