Écrire en Markdown

Markdown permet d'écrire un document structuré avec du texte brut : pas de barre d'outils, juste quelques signes. C'est devenu le langage par défaut des README, des notes et de beaucoup d'outils d'écriture.

L'essentiel

  • # Titre, ## Sous-titre pour la hiérarchie
  • **gras** et *italique* pour l'emphase
  • - élément pour une liste à puces, 1. élément pour une liste numérotée
  • [texte](url) pour un lien, `code` pour du code en ligne

💡 Anecdote - Faute de spécification unique, les implémentations divergeaient ; CommonMark (2014), porté notamment par un cofondateur de Stack Overflow, a tenté de mettre tout le monde d'accord.

Pourquoi c'est pratique

Le fichier reste lisible même sans rendu, se versionne proprement (un diff Markdown se lit), et se convertit en HTML partout. Vous écrivez le fond, l'outil s'occupe de la forme.

Prévisualiser au fur et à mesure

Le meilleur moyen d'apprendre est de voir le rendu en direct. Notre aperçu Markdown affiche le résultat à côté de votre texte, instantanément et localement, sans rien envoyer

🤓 Le saviez-vous ? Markdown a été créé en 2004 par John Gruber avec l'aide d'Aaron Swartz - futur cofondateur de Reddit et militant du web libre - qui a participé à la première implémentation.