Convertir et prévisualiser du Markdown

Tableau de bord
Documentation
API

convertit votre Markdown en HTML et affiche une prévisualisation en direct, idéal pour rédiger des READMEs, de la documentation ou des articles

Qu'est-ce que Markdown ?

Markdown est un langage de balisage léger créé par John Gruber en 2004. Il permet de rédiger du texte formaté en utilisant une syntaxe simple et lisible à l'état brut, qui est ensuite convertie en HTML.

Cet outil utilise la spécification GFM (GitHub Flavored Markdown), la variante la plus répandue, qui ajoute le support des tableaux, des cases à cocher, des blocs de code avec coloration syntaxique et des liens automatiques.

La prévisualisation à droite se met à jour en temps réel pendant la frappe. Le bouton Soumettre génère le code HTML correspondant, que vous pouvez copier ou télécharger.

Syntaxe Markdown de base

Markdown	Rendu
`# Titre 1`	Titre <h1>
`## Titre 2`	Titre <h2>
`gras`	gras
`italique`	italique
`code inline`	`code inline`
```php ... ```	Bloc de code PHP
`[texte](url)`	Lien hypertexte
`![alt](url)`	Image
`- item`	Liste non ordonnée
`1. item`	Liste ordonnée
`> citation`	Blockquote
`---`	Séparateur horizontal

Cas d'usage courants

README GitHub : rédiger la documentation d'un projet open source.
Documentation technique : écrire des guides, wikis ou pages de doc (MkDocs, Docusaurus, Hugo).
Articles de blog : la plupart des CMS (Jekyll, Ghost, Contentful) acceptent le Markdown.
Commentaires et issues : GitHub, GitLab, Jira, Notion et Slack supportent tous le GFM.
Emails formatés : convertir du Markdown en HTML pour intégrer dans un email HTML.
Notes et diaporamas : Obsidian, Notion, Marp et Reveal.js utilisent le Markdown.

Questions fréquentes

Quelle est la différence entre Markdown standard et GFM ?

Le Markdown standard (CommonMark) couvre les éléments de base : titres, listes, liens, code. GFM (GitHub Flavored Markdown) ajoute les tableaux, les listes de tâches (- [ ] item), le code clôturé avec langage (```php), les mentions et les liens automatiques. Cet outil utilise GFM via la bibliothèque league/commonmark.

Le HTML généré est-il sécurisé ?

Oui. Le convertisseur est configuré pour supprimer les balises HTML brutes (html_input: strip) et bloquer les liens non sûrs, ce qui empêche les attaques XSS. Le HTML produit est adapté à une intégration dans une page web existante.

Puis-je inclure du HTML dans mon Markdown ?

Par mesure de sécurité, le HTML brut inséré dans le Markdown est supprimé à la conversion. Si vous avez besoin d'un rendu HTML personnalisé, rédigez directement le HTML cible.

Quelle est la taille maximale du document ?

Il n'y a pas de limite stricte côté serveur pour cet outil. Pour des documents très longs (plus de quelques milliers de lignes), la prévisualisation en temps réel peut ralentir selon votre navigateur.

Exemple de requête

curl -X POST https://cdrn.fr/api/v1/tools/markdown-formatter/execute \
  -H "Content-Type: application/json" \
  -d '{"input":"..."}'

Schéma d'entrée

Champ	Type	Requis	Défaut
`input`	text	✓	–

Points d'accès

GET https://cdrn.fr/api/v1/tools - liste tous les outils disponibles
GET https://cdrn.fr/api/v1/tools/markdown-formatter - récupère le schéma de cet outil
POST https://cdrn.fr/api/v1/tools/markdown-formatter/execute - exécute cet outil avec un payload JSON