Markdown vers HTML

Markdown : ecrire des documents formates sans prise de tete

Markdown vous permet de creer des documents bien formates a partir de texte brut. Pas de menus a parcourir, pas de lutte avec un traitement de texte. Un # pour un titre, des **doubles asterisques** pour du gras, un - pour une puce, et c'est parti. C'est le format de reference sur GitHub, Notion et la plupart des plateformes de blogging.

Aide-memoire Markdown : l'essentiel en un coup d'oeil

Les bases sont vraiment simples. # donne un h1, ## un h2, et ainsi de suite jusqu'a ######. **gras** et *italique* fonctionnent exactement comme on s'y attend. Les listes a puces commencent par - ou *, les listes numerotees par 1. 2. 3. Les liens s'ecrivent [cliquez ici](https://example.com), les images c'est pareil mais avec un ! devant. Pour le code, entourez les extraits en ligne de backticks et utilisez trois backticks pour les blocs de code. Les tableaux demandent un peu plus de travail -- des pipes (|) et des tirets (-) -- mais ca reste gerable.

Markdown est vraiment partout

Si vous utilisez GitHub, vous ecrivez deja du Markdown -- README, issues, descriptions de pull requests, tout passe par la. Notion, Obsidian et Slack comprennent aussi les raccourcis Markdown. Les generateurs de sites statiques comme Jekyll, Hugo et Astro utilisent des fichiers Markdown comme source de contenu. Documentation technique, blogs, wikis, bases de connaissances internes -- Markdown est devenu le format d'ecriture par defaut dans le monde tech. Ca vaut le coup de l'apprendre meme si vous n'etes pas developpeur.

Ecrire du bon Markdown : les erreurs que tout le monde fait

Ne sautez pas de niveaux de titres -- passer de # directement a ### casse la structure du document et perturbe les lecteurs d'ecran. Mettez toujours une ligne vide entre les paragraphes (Markdown ignore les simples retours a la ligne). Dans les blocs de code, precisez le langage (par exemple ```javascript) pour activer la coloration syntaxique. Pour les documents longs, ajoutez une table des matieres -- vos lecteurs vous remercieront. Et previsualiser avant de publier est indispensable, car le rendu peut varier legerement d'une plateforme a l'autre.