- [ Accueil ](/fr/) / - [ Blog ](/fr/blog/) / - Erreurs du validateur llms.txt : bloquer ou avertir ? # Erreurs du validateur `llms.txt` : bloquer ou avertir ? Un bon validateur distingue l’unique élément obligatoire des conventions utiles. Sinon, il transforme des préférences en erreurs. Dernière mise à jour: 5 septembre 2026 Sur cette page - [ Qu’est-ce qui doit bloquer ? ](#quest-ce-qui-doit-bloquer-) - [ Qu’est-ce qui doit rester un avertissement ? ](#quest-ce-qui-doit-rester-un-avertissement-) - [ À quoi ressemblent les fichiers réels ? ](#à-quoi-ressemblent-les-fichiers-réels-) - [ Une politique transparente ](#une-politique-transparente) Dans la proposition v2, le H1 indiquant le projet ou le site est le seul élément obligatoire. Un validateur doit bloquer un H1 absent ou une syntaxe de lien impossible à parser. Il ne doit pas appeler « invalide » l’absence de résumé, une URL relative ou un fichier volumineux sans définir un profil plus strict. **À retenir** - Syntaxe obligatoire et conseil éditorial exigent des niveaux différents. - 90 réponses sur 113 commençant par un H1 utilisent une blockquote ; les 23 autres montrent que la fréquence ne crée pas une obligation. - Des codes de règles stables rendent la CI auditable. ## Qu’est-ce qui doit bloquer ? Les erreurs doivent identifier ce qu’un parseur ne peut pas interpréter selon la proposition : fichier vide, première ligne utile différente d’un H1, second H1 ou élément de liste qui n’est pas un lien Markdown. Numéro de ligne et code stable sont essentiels. `H1_REQUIRED` indique une correction ; « mauvais fichier » n’aide pas. La CI ne doit échouer que sur des règles documentées. ## Qu’est-ce qui doit rester un avertissement ? Le résumé en blockquote est optionnel. Le préambule, les sections H2, les notes et `Optional` le sont aussi. Le validateur peut les conseiller, mais ne doit pas réécrire la proposition. Une URL relative mérite un avertissement car elle peut devenir ambiguë. La taille dépend également du contexte. Une grande carte de documentation peut être volontaire, même si une sélection plus courte consomme moins de contexte. ## À quoi ressemblent les fichiers réels ? Notre snapshot contient 113 fichiers texte commençant par un H1. Quatre-vingt-dix utilisent une blockquote. Le fichier médian possède 7 sections H2 et 76 liens, tandis que les sections observées vont de 0 à 84. La fréquence ne définit donc pas la validité. Une structure courante n’est pas automatiquement obligatoire. Comparez les [exemples réels](/fr/exemples/) aux règles formelles. ## Une politique transparente Publiez les règles, leur niveau et la version de la proposition : - **Erreurs :** la structure obligatoire ne peut pas être parsée. - **Avertissements :** le contenu autorisé peut réduire portabilité ou clarté. - **Informations :** observations opérationnelles comme la taille. Testez les diagnostics dans le [validateur](/fr/validateur/), puis utilisez les [bonnes pratiques](/fr/bonnes-pratiques/) pour les décisions éditoriales. La [référence du format](/fr/llms-txt-format/) définit la grammaire et les [exemples vérifiés](/fr/exemples/) montrent la diversité réelle. ### Une blockquote manquante invalide-t-elle le fichier ? Non. Elle est optionnelle en v2, même si elle aide souvent. ### Plus de 50 Ko est-il invalide ? Non. La proposition ne fixe pas de maximum universel. ### Un fichier valide peut-il être mauvais ? Oui. La syntaxe ne juge ni la pertinence, ni la fraîcheur, ni la sécurité. ## Sources - [ llmstxt.org, format v2 ](https://llmstxt.org/) - [ llmtxt.info, statistiques de l’annuaire ](https://llmtxt.info/directory-insights.json)