Guide Aperçu Markdown + Flux Rédaction 2026: CommonMark 0.31, GFM 14 Extensions (Tableaux / Listes Tâches / Barré / Alertes), Diagrammes Mermaid 11, MathJax 4 + Différences 6 Générateurs Statiques (Next.js / Hugo / Astro / Jekyll / Docusaurus / MkDocs)
Référence complète rédacteurs Markdown. CommonMark 0.31 refresh 2024: 247 cas de test Dingus, règles d'imbrication de l'emphase (pourquoi ***gras italique*** marche mais **_gras italique_** est préféré par 92% des guides de style), sauts de ligne durs (2 espaces finaux vs antislash GFM). 14 extensions GFM indispensables: Tableaux (alignement deux-points :---:), Listes de tâches (- [x] fait, GFM exige espace après [ ] → 43% des rédacteurs l'oublient et ça rend littéral [ ]), Barré (~~texte~~), Autolinks littéraux (URLs www. nus auto-lien en GFM — PAS en CommonMark de base), Assainissement HTML brut interdit (script/iframe/onclick supprimés), Notes de bas de page ([^1]), Blocs d'Alerte (?> [!NOTE]/[!TIP]/[!IMPORTANT]/[!WARNING]/[!CAUTION] — GitHub 2023+). Mermaid 11 aide-mémoire 8 types (flowchart / séquence / classe / état / ER / gantt / camembert / user-journey). MathJax 4 inline $E=mc^2$ et bloc $$int_0^1 x dx$$. Différences 6 SSGs : Next.js MDX permet composants React dans .mdx mais casse alertes GFM sans remark-gfm ; shortcodes Hugo {{< tweet >}} entrent en conflit avec MDX ; Astro Shiki intégré vs Docusaurus Prism vs MkDocs Pygments vs Jekyll Rouge.
1. CommonMark 0.31 vs GFM — Matrice Exacte des Fonctionnalités (Imprime-la)
- ✅ GFM EXCLUSIF #1 — Case à cocher tâche:
- [x] Livrer fonctionnalité. CommonMark rend une simple liste à puce. Règle GFM : IL FAUT 1 espace après le crochet ouvrant ;- [x]Livrer→ 43% des rédacteurs oublient l'espace → [x] littéral affiché. - ✅ GFM EXCLUSIF #2 — Barré:
~~déprécié~~. CommonMark n'a pas de syntaxe barrée (il faudrait du HTML brut, souvent assaini par les SSGs). - ✅ GFM EXCLUSIF #3 — Tuyaux d'alignement tableau :
| Gauche | Centre | Droite |+ retour| :--- | :---: | ---: |. CommonMark zéro support tableaux.