Introduction

Le Markdown est une syntaxe à la fois basique et légère visuellement mais aussi suffisamment large pour rédiger toute sorte de document qui n'ont pas besoin de contrôle précis de la mise en page ni de fonctionnalités de bureautique très avancée... Si vous avez ces besoins, dirigez-vous vers Latex ou Typst.

Cela ne fait pas tellement de sens de réécrire la liste des symboles de la syntaxe, car il existe déjà énormement de cheatsheets de Markdown, en voici une sur markdownguide.org. Laisser cette liste ouverte pendant que vous faites l'entrainement plus bas.

Choses à savoir

Les espaces et les retours à la ligne sont ignorés. Pour insérer un retour à ligne simple mais ne pas démarrer un nouveau paragraphe, il faut insérer deux espaces puis un retour à la ligne.
L'aperçu du Markdown dépendra du previewer utilisé (qui génére et affiche en général du HTML avec un style propre), paril pour le rendu PDF, ce n'est jamais le même selon les outils.
Certains convertisseurs ou previewers sont plus poussés que d'autres, il n'existe pas de normes du Markdown mais il existe des variantes qui ont été spécifiées comme GFM (GitHub Flavoured Markdown) ou CommonMark. Certains supporte d'inclure des parties d'HTML, d'autres non pour des raisons de sécurité.
Certaines syntaxes avancées comme les emojis, les notes de bas de pages, et d'autres ont été inventés ou développés dans certains outils et d'autres ne les ont pas adopté, pensez au fait que certaines syntaxes n'aient pas le même rendu ou pas du tout de rendu sur d'autres previewers...
Pour faire des commentaires, c'est (malheureusement un peu long) comme en HTML: . Probablement que votre IDE permet d'insérer rapidement des commentaires ou de commenter des lignes existantes, ces raccourcis seront bien utiles dans ce cas!