Qu'est-ce que le Markdown ?

Markdown est un langage de balisage léger créé par John Gruber en 2004. Il permet d'écrire du contenu formaté en texte brut avec une syntaxe simple : # pour les titres, ** pour le gras, * pour l'italique, [texte](url) pour les liens. Le résultat est ensuite converti en HTML pour l'affichage.

Markdown s'est imposé comme standard de fait pour la documentation technique (GitHub, GitLab), les blogs, les wikis, les notes personnelles et les messageries (Discord, Slack, Reddit). Sa popularité vient de sa simplicité — vous restez concentré sur le contenu sans être distrait par les boutons d'une interface WYSIWYG.

Syntaxe de base

• Titres : utilisez # pour H1, ## pour H2, ### pour H3, et ainsi de suite jusqu'à ###### pour H6.
• Gras : encadrez le texte avec des astérisques doubles ou des underscores doubles. Italique : utilisez un seul astérisque ou underscore.
• Listes : commencez les lignes par - ou * pour des puces, ou 1. pour des listes numérotées. Imbriquez avec une indentation.
• Liens : [texte du lien](URL). Images : .
• Code : utilisez des backticks pour le code en ligne, et trois backticks pour des blocs de code délimités avec un langage optionnel pour la coloration syntaxique.

Comment utiliser cet outil

Saisissez votre Markdown dans la zone de gauche. La prévisualisation HTML rendue apparaît en temps réel à droite. Vous pouvez copier le HTML généré ou télécharger le résultat. L'outil supporte la syntaxe GitHub Flavored Markdown (GFM), incluant tables, listes de tâches et blocs de code colorisés.

GitHub Flavored Markdown

Le GitHub Flavored Markdown étend le Markdown standard avec des tableaux (colonnes séparées par des barres verticales), des listes de tâches (cases à cocher avec - [ ] et - [x]), du texte barré (entouré de doubles tildes), des URL liées automatiquement et des blocs de code délimités avec coloration syntaxique. Cet outil prend en charge toutes les fonctionnalités GFM, ce qui le rend idéal pour prévisualiser les fichiers README et la documentation avant de les pousser sur GitHub.

Questions fréquentes

Markdown ou HTML : que choisir ?

Markdown pour la rédaction (rapide, lisible). HTML pour le contrôle précis du rendu (classes CSS, attributs ARIA). Heureusement, Markdown autorise le HTML inline pour les cas avancés. La plupart des outils convertissent Markdown -> HTML à la publication.

Mes textes sont-ils privés ?

Oui. La conversion se fait dans votre navigateur. Aucun contenu n'est envoyé à un serveur — sûr pour des notes confidentielles ou des brouillons d'articles.