Aperçu Markdown
Aperçu Markdown gratuit avec sortie HTML sécurisée.
Aperçu Markdown dans le navigateur
Écrivez du Markdown à gauche et examinez le rendu à droite. L'aperçu prend en charge les titres, l'emphase, les liens, les listes, les citations, les filets et les blocs de code délimités.
**Il faut savoir que Markdown n'a pas de spécification officielle unique.** La syntaxe originale de 2004 a laissé bien des cas indéfinis, si bien que GitHub, CommonMark et les autres divergent sur des détails comme les listes imbriquées, les retours à la ligne ou les tirets bas au milieu d'un mot : un document impeccable à un endroit peut se présenter autrement ailleurs. Le retour à la ligne est ce qui déroute le plus, car **dans la plupart des implémentations un simple retour ne provoque pas de saut de ligne dans le paragraphe** : il faut deux espaces en fin de ligne ou une ligne vide.
Cet outil échappe le HTML brut avant l'affichage, de sorte que ce que vous collez ne peut y exécuter aucun script.
Comment se servir de l'aperçu
- Coller ou écrire du Markdown Saisissez dans l'éditeur de gauche ; l'aperçu se met à jour aussitôt.
- Vérifier le rendu Passez en revue titres, listes, liens et code avant de publier.
- Copier le HTML au besoin Le HTML sûr produit peut être repris dans un éditeur compatible.
Astuces pour en tirer le meilleur parti
- Encadrez le code de trois accents graves pour conserver l'indentation et les symboles de l'original.
- L'aperçu affiche délibérément le HTML brut comme du texte, afin de réduire le risque d'injection de script.
- Les tableaux et les listes imbriquées sont ce qui se déforme le plus selon la profondeur d'indentation : ajustez-les en regardant l'aperçu.
Cas d'usage
Vérifier un README en l'écrivant
**Ce que montre votre éditeur et ce que rend GitHub ne concordent pas nécessairement.** Cela permet de regarder avant de publier.
Réussir tableaux et listes imbriquées
Là où le résultat tient à la position d'un symbole ou à l'indentation, voir va plus vite que raisonner.
Emporter un article en HTML
**Le HTML produit se copie tel quel** et fait un bon brouillon à coller dans un système de publication.
Transformer un document en PDF à transmettre
Une procédure ou des notes écrites en Markdown prennent une forme que l'on peut simplement remettre à quelqu'un.
Apprendre la syntaxe en écrivant
**La saisie et le rendu côte à côte : on retient ce que fait chaque symbole en l'essayant.**
Termes de Markdown
- Markdown
- Syntaxe légère qui balise titres et emphase à l'aide de signes de ponctuation. **Il n'existe pas de spécification officielle unique et les implémentations diffèrent.**
- CommonMark
- Spécification qui a fixé les cas laissés indéfinis par l'originale. La plupart des implémentations s'appuient aujourd'hui dessus.
- GitHub Flavored Markdown
- CommonMark augmenté des tableaux, du texte barré et des listes de tâches. **L'aspect d'un document sur GitHub suit cette variante.**
- Traitement du retour à la ligne
- **Dans presque toutes les implémentations, un simple retour ne coupe pas la ligne dans le paragraphe.** Il faut deux espaces en fin de ligne ou une ligne vide.
- Bloc de code délimité
- Zone encadrée par trois accents graves. Nommer le langage après l'ouverture active la coloration.
- Assainissement
- Retrait des éléments dangereux d'un HTML collé. **Cet aperçu y procède afin d'afficher sans risque.**
Questions fréquentes
Pourquoi regarder avant de publier
Markdown s'écrit avec aisance, mais il suffit d'un caractère manquant pour changer la structure d'une page. Un aperçu en direct rend visibles titres, liens et listes avant que le texte ne parte dans un README, un ticket, un wiki ou un système de publication.
Cet outil préfère un sous-ensemble commun et sûr à l'exécution d'un HTML quelconque. Il sert donc aussi bien à vérifier un contenu copié d'une source douteuse qu'à rédiger le sien.