Aperçu Markdown

Qu'est-ce que Markdown ?

Markdown est un langage de balisage léger créé par John Gruber en 2004 pour écrire du texte formaté avec un simple clavier. **gras**, # titres, - listes — de petites conventions qui se transforment en HTML propre. C'est le format par défaut pour les fichiers README sur GitHub, les posts sur Reddit et Stack Overflow, les générateurs de documentation et la plupart des applis de prise de notes. Cet aperçu parse votre entrée avec la librairie marked et affiche le HTML rendu à côté de la source pour itérer vite sans quitter la page.

Comment utiliser cet aperçu

Tapez ou collez du Markdown à gauche. Le panneau de droite se rerend pendant que vous tapez. Activez Saveur GitHub pour activer les extras comme les tableaux, les listes de tâches et le barré. Activez Sauter à la ligne si vous voulez que chaque saut de ligne devienne un <br> (la plupart des éditeurs préfèrent le défaut, qui exige une ligne vide entre paragraphes). Cliquez sur Copier le HTML pour mettre le HTML rendu dans votre presse-papiers — collez dans un CMS, un e-mail ou tout endroit qui accepte du HTML.

Référence rapide de la syntaxe

Les jetons Markdown les plus courants. L'aperçu accepte la spec CommonMark complète plus les extensions GitHub-flavored quand le bouton GFM est activé.

Markdown	Rendu
`# Title`	Titre de niveau 1
`bold`	gras
`italic`	italique
`code`	`code en ligne`
`[text](url)`	Lien hypertexte
`- item`	Élément de liste à puces
`> quote`	Citation
`\| a \| b \|`	Ligne de tableau (GFM)

Questions fréquentes

Mon Markdown est-il envoyé quelque part ?

Non. Le parsing se fait entièrement dans votre navigateur via la librairie marked chargée depuis un CDN public. Une fois le script chargé, plus aucune requête n'est faite — la frappe et le rendu sont 100 % hors ligne. Ouvrez DevTools > Réseau et vous ne verrez aucun trafic pendant que vous éditez. Sûr pour des brouillons, des docs internes et tout ce que vous ne colleriez pas dans un éditeur hébergé.

Que fait le bouton GFM ?

GitHub-flavored Markdown ajoute des extensions à la base CommonMark : tableaux, listes de tâches (- [x] fait), barré (~~texte~~), liens automatiques et règles légèrement différentes pour listes/paragraphes. Bouton activé, vous voyez le rendu de GitHub ; désactivé, du CommonMark strict. La plupart des plateformes (GitHub, GitLab, Stack Overflow) utilisent GFM, donc laissez-le activé par défaut.

Pourquoi un seul saut de ligne ne crée-t-il pas une nouvelle ligne ?

Selon la spec Markdown, un seul saut de ligne n'est qu'un espace — les paragraphes sont séparés par des lignes vides. Cela correspond au comportement de Word/Google Docs et c'est ce que fait GitHub. Si vous voulez que chaque saut de ligne casse (par ex. pour de la poésie, des listes de noms, des lignes de log), activez le bouton Sauter à la ligne.

La sortie est-elle sûre à coller dans mon site ?

Soyez prudent avec du Markdown non fiable. Markdown autorise le passage de HTML brut, donc une source malveillante pourrait embarquer une balise <script> qui s'exécute quand vous collez le HTML rendu là où il n'est pas nettoyé. Cet aperçu est pour l'inspection — si vous injectez du Markdown soumis par un utilisateur dans votre site, faites passer la sortie par un sanitiseur comme DOMPurify côté serveur avant de servir.

Puis-je exporter en PDF ou Word ?

Pas directement ici, mais le workflow est simple : copiez le HTML rendu avec le bouton, collez-le dans un éditeur de document (Google Docs, Pages, LibreOffice préservent tous le formatage HTML au collage), et exportez de là. Pour le PDF, le plus simple est d'imprimer le HTML rendu — la boîte de dialogue d'impression de votre navigateur a une destination « Enregistrer en PDF ».

Pourquoi du HTML brut s'affiche-t-il dans ma sortie ?

Markdown autorise volontairement le HTML inline — tout ce qui se trouve entre < et > et ressemble à une balise est passé tel quel. Pour afficher du HTML plutôt que de le rendre, échappez les chevrons (< et >) ou enrobez l'extrait dans un bloc de code à clôture (triple backticks). Le même truc marche pour toute ponctuation Markdown littérale.

Aperçu Markdown