# 📋 Référentiel Complet Markdownlint (MD001 - MD056)Voici le guide complet des 56 règles de markdownlint, présentées avec le détail technique, leur cause et la méthode de correction. Toutes ces règles sont, par défaut, à l’état Activé (Vrai) dans une configuration standard.
| Code | Nom humain | Cause probable | ✅ Correction (Statut : Activé) |
|---|---|---|---|
| MD001 | Heading levels | Saut de niveau (ex: # suivi de ###). |
Suivre l’ordre logique (#, ##, ###). |
| MD002 | First heading level | Le premier titre n’est pas un H1. | Commencer le document par un seul #. |
| MD003 | Heading style | Mélange de styles (atx # vs setext ===). |
Utiliser un style unique (recommandé : #). |
| MD004 | Unordered list style | Mélange de puces (*, -, +). |
Choisir un seul symbole pour tout le fichier. |
| MD005 | Inconsistent indentation | Mauvais alignement des puces de liste. | Aligner verticalement les puces de même niveau. |
| MD006 | Start bullets at col 1 | Listes de niveau 1 indentées par erreur. | Commencer les listes principales à la colonne 1. |
| MD007 | Unordered list indentation | Espacement incohérent des sous-listes. | Utiliser 2 espaces par niveau d’indentation. |
| MD009 | Trailing spaces | Espaces invisibles en fin de ligne. | Supprimer les espaces après le dernier mot. |
| MD010 | Hard tabs | Utilisation de tabulations au lieu d’espaces. | Remplacer les tabulations par des espaces. |
| MD011 | Reversed link syntax | Syntaxe de lien inversée (lien)[texte]. |
Utiliser le format [texte](lien). |
| MD012 | Multiple blank lines | Trop de lignes vides consécutives. | Ne laisser qu’une seule ligne vide maximum. |
| MD013 | Line length | Ligne dépassant 80 ou 120 caractères. | Couper les lignes ou désactiver pour les URLs. |
| MD014 | Dollar signs in code | Signes $ devant chaque ligne de commande. |
Retirer les $ (sauf si mélange entrée/sortie). |
| MD018 | No space after hash | Manque d’espace : #Titre. |
Ajouter un espace : # Titre. |
| MD019 | Multiple spaces after hash | Trop d’espaces : # Titre. |
Un seul espace : # Titre. |
| MD020 | Closed atx style | Espace manquant avant le # final. |
Format correct : # Titre #. |
| MD021 | Multiple spaces inside hash | Trop d’espaces dans le style clos. | Un seul espace : # Titre #. |
| MD022 | Blanks around headings | Titre collé au texte. | Ligne vide avant ET après chaque titre. |
| MD023 | Heading indentation | Titre commençant par des espaces. | Commencer les titres au début de la ligne. |
| MD024 | Multiple headings same content | Deux titres identiques dans le document. | Rendre chaque titre unique. |
| MD025 | Multiple top-level headings | Plusieurs titres H1 (#). |
Un seul H1 par document. |
| MD026 | Trailing punctuation | Ponctuation interdite en fin de titre. | Supprimer . , ; : ! ? à la fin des titres. |
| MD027 | Multiple spaces in blockquote | Trop d’espaces après le >. |
Un seul espace : > Texte. |
| MD028 | Blank line in blockquote | Ligne vide séparant un bloc de citation. | Ne pas couper les blocs par des lignes vides. |
| MD029 | Ordered list prefix | Mauvaise numérotation (ex: 1, 2, 3). | Utiliser 1. pour chaque ligne (auto-incrément). |
| MD030 | Spaces after list markers | Trop/peu d’espaces après la puce. | Un seul espace après - ou 1.. |
| MD031 | Blanks around code blocks | Bloc de code collé au texte. | Ligne vide avant et après les ```. |
| MD032 | Blanks around lists | Liste collée au texte. | Ligne vide avant et après les listes. |
| MD033 | Inline HTML | Présence de balises HTML (ex: <div>). |
Utiliser la syntaxe Markdown pure. |
| MD034 | Bare URL used | URL brute sans crochets < >. |
Entourer l’URL : <http://lien.com>. |
| MD035 | Horizontal rule style | Mélange de styles de lignes --- / ***. |
Utiliser un style unique de séparateur. |
| MD036 | Emphasis as heading | Texte en gras utilisé comme titre. | Utiliser un vrai titre #. |
| MD037 | Spaces inside emphasis | Espaces dans le gras ** texte **. |
Supprimer les espaces : **texte**. |
| MD038 | Spaces inside code span | Espaces dans le code ` code `. |
Supprimer les espaces : `code`. |
| MD039 | Spaces inside link text | Espaces dans [ lien ]. |
Supprimer les espaces : [lien]. |
| MD040 | Fenced code language | Bloc de code sans langage spécifié. | Ajouter le nom (ex: ```python). |
| MD041 | First line should be H1 | Le fichier ne commence pas par un titre. | Ajouter un titre # en ligne 1. |
| MD042 | No empty links | Lien vide [texte](). |
Ajouter une URL ou une ancre. |
| MD043 | Required heading structure | Structure de titres non conforme. | Suivre le template de titres défini. |
| MD044 | Proper names | Mauvaise casse (ex: javascript). | Utiliser la casse correcte (ex: JavaScript). |
| MD045 | Images should have alt text | Image sans description alt. | Ajouter du texte : . |
| MD046 | Code block style | Mélange de styles de blocs de code. | Garder uniquement les ``` ou l’indentation. |
| MD047 | File end newline | Pas de saut de ligne final. | Ajouter une ligne vide à la fin du fichier. |
| MD048 | Code fence style | Mélange de ``` et ~~~. |
Utiliser un seul type de délimiteur. |
| MD049 | Emphasis style | Mélange de _ et * pour l’italique. |
Utiliser un seul style (recommandé : _). |
| MD050 | Strong style | Mélange de __ et ** pour le gras. |
Utiliser un seul style (recommandé : **). |
| MD051 | Link fragments | Ancre interne # invalide. |
Vérifier que le titre ciblé existe. |
| MD052 | Reference links | Lien de référence non défini. | Ajouter la définition [id]: url en bas. |
| MD053 | Unused reference links | Référence définie mais non utilisée. | Supprimer les références inutiles. |
| MD054 | Link image style | Mélange de styles de liens/images. | Uniformiser le format (inline vs reference). |
| MD055 | Table pipe style | Manque de pipes aux extrémités. | Ajouter des \| au début et à la fin des lignes. |
| MD056 | Table column count | Nombre de colonnes incohérent. | Aligner le nombre de séparateurs \| par ligne. |
1 🚀 Prochaine étape
Souhaitez-vous que je génère un fichier de configuration .markdownlint.json personnalisé pour forcer l’activation de ces règles dans votre projet ?