# Markdown linter - corriger les problèmes de formatage dans les fichiers md > Corrigez automatiquement les problèmes de formatage Markdown avec l'outil markdownlint et Docker. Apprenez à vérifier, configurer et utiliser le flag --fix pour des fichiers .md propres et cohérents. ---  **TL;DR** Cet article montre comment linter et corriger automatiquement des fichiers Markdown avec l'image Docker `peterdavehello/markdownlint` : scanner un projet, ignorer des dossiers comme `vendor` ou `node_modules` via `.markdownlint_ignore`, désactiver certaines règles via `.markdownlint.json`, et appliquer les corrections automatiques avec le flag `--fix`, le tout branché sur un target `make lint`. Vous écrivez des fichiers Markdown `.md` (et vous avez bien raison) et vous voulez juste vérifier (et corriger automatiquement) quelques problèmes comme plusieurs lignes vides d'affilée, un mélange de types de puces (`-` et `*` dans le même document), un titre `#` suivi d'un `###` (autrement dit, vous avez oublié le niveau `##`) et bien d'autres. Il existe un outil pour ça : Markdown lint et une image Docker `peterdavehello/markdownlint`. Voyons comment l'utiliser. *Comme tout linter, il est surtout utile quand vous n'avez plus à y penser : [Git - pre-commit-hooks](/blog/git-precommit) liste un hook `markdownlint` qui s'exécute à chaque commit.* En lançant `docker run --rm -v .:/md peterdavehello/markdownlint markdownlint .`, vous scannez votre dossier courant (récursivement), à la recherche de tous les fichiers Markdown, et vous obtenez la liste des erreurs éventuelles. Et la liste peut être énorme si vous utilisez des dépendances comme, pour PHP, le dossier `vendor` ou `node_modules` pour npm/yarn. Il suffit de les ignorer. ## Ignorer certains fichiers/dossiers {#ignore-some-filesfolders} Créez un fichier appelé `.markdownlint_ignore` à la racine de votre projet avec ce contenu : **.markdownlint\_ignore** ``` node_modules/**/*.markdown node_modules/**/*.md vendor/**/*.markdown vendor/**/*.md ``` Cette fois, lancez `docker run --rm -v .:/md peterdavehello/markdownlint markdownlint --ignore-path .markdownlint_ignore .`. La liste sera probablement plus courte et ne contiendra que vos fichiers. ## Ignorer certaines erreurs {#ignore-some-errors} Vous pouvez ignorer certaines erreurs détectées, comme l'utilisation de HTML inline, en créant un fichier appelé `.markdownlint.json`. Vous trouverez un exemple sur . Voir pour plus d'informations. Pour utiliser votre fichier de configuration, lancez maintenant `docker run --rm -v .:/md peterdavehello/markdownlint markdownlint --config .markdownlint.json --ignore-path .markdownlint_ignore .`. ## Certaines erreurs peuvent être corrigées automagiquement {#some-errors-can-be-fixed-automagically} Certaines erreurs peuvent être corrigées automagiquement, comme les lignes vides multiples ou les espaces superflus en fin de ligne. Le flag ici est `--fix` mais attention : puisque les corrections modifient les fichiers, vous devez aussi ajouter le flag `--user $(id -u):$(id -g)` pour que les fichiers soient mis à jour tout en restant votre propriété. ## On assemble le tout {#put-all-together} L'instruction finale devient : `docker run --rm --user $(id -u):$(id -g) -v .:/md peterdavehello/markdownlint markdownlint --fix --config .markdownlint.json --ignore-path .markdownlint_ignore .` et c'est celle que je lance chaque fois que je publie sur ce blog. ## Se simplifier la vie {#make-it-easy} Vous n'avez évidemment pas besoin de retenir la commande entière. Avec un [Makefile](/blog/tags/makefile) dans votre projet, vous pouvez créer un nouveau `target` qui contient la commande. Pour ce blog par exemple, je lance `make lint` dans mon processus de déploiement. Vous pouvez le voir [ici](https://github.com/cavo789/blog/blob/main/makefile#L42-L45).