Formateur Markdown

Collez un document Markdown et le formateur le réécrit dans un style cohérent : corrige les sauts de niveau de titre (pas de H2 après H4), remplit les colonnes de tableau pour s’aligner dans la source, impose une seule ligne vide entre les blocs, normalise les marqueurs de liste en -, réduit les séries de lignes vides, et trie les définitions de liens de style référence en bas. Le HTML rendu ne change pas, seul le fichier source devient plus propre, donc les différences deviennent lisibles.

Comment le formateur réécrit le Markdown

  1. 1

    Collez le Markdown

    Déposez le document brut, README, page de docs, notes de réunion.

  2. 2

    Choisissez les options de style

    Marqueur de liste (`-`/`*`), style de titre (ATX/Setext), alignement des tableaux, colonne de remplissage.

  3. 3

    Formater

    L'outil analyse le document en un AST et le re-sérialise avec le style choisi.

  4. 4

    Comparez la sortie

    Une vue côte à côte montre ce qui a changé avant que vous la colliez à nouveau.

Ce que le formateur corrige

  • Marqueurs de liste. *, -, + sont tous normalisés en un caractère cohérent (par défaut -).
  • Hiérarchie des titres. Avertit (ou promeut) lorsque H2 est suivi de H4 sans H3 entre les deux.
  • Lignes vides. Exactement une ligne vide entre les blocs ; pas de séries de trois lignes ou plus.
  • Tableaux. Remplit chaque colonne pour que les pipes s’alignent dans la source, même si les rendus Markdown ne s’en soucient pas.
  • Espaces de fin. Supprime les espaces de fin sur chaque ligne sauf le marqueur de saut de ligne intentionnel à deux espaces.
  • Liens de référence. Collecte les définitions [label]: url à la fin du document, triées par ordre alphabétique.
  • Blocs de code. Le tag de langue est normalisé en minuscules ; les blocs de code basés sur l’indentation deviennent des blocs délimités.

Options de style que vous pouvez définir

Option Par défaut Alternatives
Marqueur de liste - *, +
Style de titre ATX Setext pour H1/H2
Délimiteur d’emphase * _
Délimiteur de gras ** __
Colonne de remplissage 0 (désactivé) 80, 100, 120
Trier les liens de référence activé désactivé

Pourquoi un Markdown cohérent est important

Dans un dépôt d’équipe, un Markdown incohérent produit des différences bruyantes : chaque fois que quelqu’un enregistre un fichier avec un éditeur différent, les marqueurs de liste changent et les tableaux se réorganisent. Un formateur impose un style afin que les relecteurs de pull requests ne voient que les changements de contenu. Pensez-y comme à prettier pour la prose.

Quand ne pas formater

  • Blocs de code délimités restent intacts, le formateur ne touchera jamais au contenu d’un bloc de code. Si le formatage change le code, c’est un bug.
  • Sauts de ligne durs intentionnels à des largeurs étroites (readme.md sur un projet terminal) sont réemballés si vous activez la colonne de remplissage. Désactivez le remplissage si vous conservez des sauts de ligne ajustés à la main.
  • Blocs HTML intégrés passent sans changement.

Solutions de remplacement compatibles

Si vous préférez une CLI locale, le formateur utilise les mêmes règles AST que remark-stringify avec le plugin remark-gfm. prettier --parser markdown produit un résultat similaire.

Questions fréquentes

Non. Le formateur ne réécrit que la source, la sortie HTML rendue avant et après devrait être équivalente. Si vous voyez un changement de rendu, signalez-le comme un bug.

Non. Le front-matter YAML ou TOML en haut du fichier est détecté et passe sans changement.

Oui, définissez la colonne de remplissage à 80, 100 ou 120 et les paragraphes seront réemballés. Les lignes à l’intérieur des blocs de code ne sont jamais touchées.

Non. Le formateur suppose que vos liens fonctionnent ; il réorganise seulement les définitions de liens de référence. Utilisez un outil de vérification de liens séparément.

Non. L’analyse et le formatage se déroulent dans votre navigateur ; le contenu ne quitte jamais votre appareil.

Outils similaires

Outil disponible dans d’autres langues