Analyseur Markdown

GFM (GitHub Flavored Markdown) est un dialecte de Markdown utilisé par GitHub. Il étend le Markdown standard avec des fonctionnalités comme les tableaux, les listes de tâches, le texte barré et les liens automatiques.

L'analyseur affiche les blocs de code délimités. Pour une coloration syntaxique complète avec des couleurs, vous pouvez le combiner avec une feuille de style CSS qui met en forme les éléments de code.

Oui ! Rédigez votre Markdown dans l'éditeur, copiez le HTML rendu et utilisez-le dans votre documentation, blog ou site web.

Le Markdown original (2004) laissait de nombreux cas limites non définis, si bien que les implémentations ont divergé. CommonMark est la spécification rigoureuse qui les résout ; GFM (GitHub Flavored Markdown) est CommonMark plus des extensions : tableaux, listes de tâches, texte barré, liens automatiques et un filtre disallowed-raw-HTML. Cet outil effectue le rendu en GFM, à l'identique de ce que vous voyez sur GitHub.

Entourez le code en ligne de backticks simples. Les blocs délimités utilisent trois backticks avec un tag de langage pour la coloration syntaxique - comme ```python sur la première ligne - ou indentez chaque ligne de quatre espaces (l'ancienne syntaxe, qui interagit mal à l'intérieur des listes). Les triples tildes fonctionnent aussi comme délimiteur lorsque votre code contient lui-même des backticks.

Oui - les balises HTML en ligne passent telles quelles dans la sortie. L'extension disallowed-raw-HTML de GFM ne supprime que quelques balises dangereuses (script, style, iframe et consorts) lorsque le filtre est activé. Deux réserves : le HTML de niveau bloc englobe du contenu dans lequel la syntaxe Markdown cesse d'être traitée (les lignes vides ont leur importance), et tout Markdown soumis par des utilisateurs doit être assaini contre le XSS au-delà d'un simple filtre de balises.

Des lignes séparées par des pipes avec une ligne de délimitation en tirets sous l'en-tête. Les deux-points définissent l'alignement : deux-points-tiret à gauche pour la gauche (par défaut), deux-points aux deux extrémités pour centrer, tiret-deux-points pour la droite. Les cellules ne peuvent pas contenir d'éléments de bloc ; échappez une pipe littérale avec \| ; et les pipes extérieures de chaque ligne sont optionnelles. Les mises en page plus complexes nécessitent du HTML brut ou un moteur de documentation.

Les suspects habituels : une indentation incohérente (les éléments imbriqués doivent généralement s'aligner sur le premier caractère du contenu de l'élément parent), une ligne vide manquante entre un paragraphe et une liste, ou des tabulations mélangées à des espaces. CommonMark spécifie des règles exactes pour tous ces cas. Convertir les tabulations en espaces et ajouter des lignes vides autour des listes corrige la grande majorité des bugs d'imbrication.