Éditeur Markdown

C'est quoi un éditeur Markdown ?

Un éditeur Markdown, c'est un environnement de rédaction côte à côte : d'un côté vous tapez du Markdown en texte brut, de l'autre l'aperçu se met à jour en temps réel. C'est le format qui fait tourner les README sur GitHub, les portails de documentation, les générateurs de sites statiques, les plateformes de blog, des apps de prise de notes comme Obsidian, et même des outils de chat comme Discord ou Slack.

Tout l'intérêt du Markdown, c'est de rester lisible en texte brut tout en se transformant en HTML structuré au moment du rendu. Vous passez moins de temps à jongler avec une barre d'outils et plus de temps à écrire — c'est précisément pour ça que les rédacteurs techniques et les développeurs l'adorent.

La plupart des éditeurs Markdown modernes prennent en charge le *GitHub-Flavored Markdown* (GFM), qui ajoute les tableaux, les listes de tâches, les blocs de code avec indication de langage, les autoliens et le texte barré, en plus de la spécification CommonMark d'origine.

Ce que vous allez apprendre en utilisant un éditeur Markdown

• Le Markdown, c'est du texte brut — lisible directement dans votre éditeur *et* convertible en HTML, sans barre d'outils ni mise en forme cachée.
• Titres, listes, liens et emphase couvrent 90 % des besoins de rédaction. Les tableaux et les blocs de code couvrent l'essentiel des 10 % restants.
• Les blocs de code avec une indication de langage ( js , python ) déclenchent la coloration syntaxique chez de nombreux moteurs de rendu.

Utiliser un éditeur Markdown étape par étape

1. 1

   Commencez à écrire dans le panneau de gauche

   Utilisez # pour les titres, * ou _ pour l'emphase, - pour les listes. Le panneau de droite se met à jour à mesure que vous tapez.

2. 2

   Ajoutez de la structure

   Insérez des titres, des blocs de code et des tableaux pour organiser le document. La plupart des éditeurs proposent des raccourcis clavier (Ctrl+B, Ctrl+I) pour la mise en forme courante.

3. 3

   Vérifiez le rendu HTML

   Comparez l'aperçu en direct avec la source. Si quelque chose ne s'affiche pas comme prévu, c'est en général à cause d'une ligne vide manquante ou d'un bloc de code mal fermé.

4. 4

   Copiez ou téléchargez

   Copiez la source Markdown dans votre README, ou copiez le HTML pour le coller dans un mail, un CMS, ou tout outil qui ne comprend pas le Markdown.

Antisèche de la syntaxe Markdown

Les 80 % de Markdown que vous utiliserez tous les jours. Le reste se trouve en deux clics. Specs : CommonMark et GitHub-Flavored Markdown.

Exemples Markdown à essayer

# Project Name
A short description in one or two sentences.
## Install
```bashnpm install project-name```
## Quick start
- Step 1- Step 2- Step 3

| Feature | Free | Pro ||---------|:----:|:---:|| Editor  |  ✓   |  ✓  || Export  |      |  ✓  |

- [x] Draft the post- [x] Add screenshots- [ ] Publish

Erreurs Markdown classiques

• Oublier les lignes vides autour des listes, des tableaux et des blocs de code. La plupart des moteurs de rendu ont besoin d'une ligne vide pour démarrer un nouveau bloc.
• Mélanger tabulations et espaces dans une liste — certains moteurs cassent silencieusement l'indentation.
• Mettre du HTML brut dans un bloc de code et s'attendre à ce qu'il s'affiche. Un bloc de code est *littéral* — c'est précisément son rôle.

FAQ — Éditeur Markdown