Markdown GitHub (GFM) vers HTML

CommonMark vs GitHub Flavored Markdown

CommonMark est une spécification stricte et bien définie du Markdown. Elle couvre les paragraphes, les titres (ATX et setext), les listes, les blocs de code, les liens, les images et la mise en forme inline. CommonMark ne comprend pas les tableaux ni les cases à cocher.

Le GFM est un sur-ensemble de CommonMark. GitHub a introduit le GFM pour ajouter des fonctionnalités nécessaires à la documentation de dépôts. La spécification GFM est formellement définie et publiquement disponible. Flowfiles supporte le GFM complet avec toutes les extensions listées ci-dessous.

Syntaxe des tableaux GFM et sortie HTML

Les tableaux GFM utilisent des pipes (|) pour séparer les colonnes. La deuxième ligne est une ligne séparatrice avec des tirets ; les deux-points contrôlent l'alignement :

| Produit  | Prix  | Stock |
|:---------|------:|:-----:|
| Widget A |  9,99 |  ✓   |
| Widget B | 24,50 |  ✗   |

Cela produit un tableau HTML complet avec <thead>, <tbody> et style="text-align:..." sur chaque cellule. L'alignement est contrôlé par la ligne séparatrice : :--- aligne à gauche, ---: à droite, et :---: centre la colonne.

Cases à cocher GFM

Les listes de tâches utilisent des items de liste commençant par [ ] (non coché) ou [x] (coché) :

- [x] Configurer le projet
- [x] Écrire les tests
- [ ] Déployer en production

Chaque item est rendu comme un <li> contenant un <input type="checkbox"> désactivé, préservant l'état coché en lecture seule. C'est le comportement de GitHub dans les issues et les pull requests.

Barré et blocs de code fencés

Le barré GFM entoure le texte de deux tildes : ~~fonctionnalité dépréciée~~ produit <del>fonctionnalité dépréciée</del>.

Les blocs de code fencés utilisent trois backticks ou tildes, suivis optionnellement d'un identifiant de langage :

```python
def bonjour(nom):
    return f"Bonjour, {nom} !"
```

La sortie est un bloc <pre><code class="language-python">…</code></pre>. La classe language-python est compatible avec les bibliothèques de coloration syntaxique telles que Prism.js et highlight.js.