Introduction

Le Markdown est une syntaxe textuelle de rédaction de documents. Elle est facile et rapide à prendre en main. Le Markdown est largement utilisé en informatique mais aussi diverses systèmes de prises de notes ou de messages (Discord, Bear, Loqseq, Obsidian, Typora, ...). On l'utilise quand le contrôle précis de la mise en page n'est pas nécessaire...

Démarrer avec Markdown

En 5 minutes de lectures de ce genre de résumé de référence, tu auras compris les bases.

Laisser cette liste ouverte pendant que vous faites l'entrainement plus bas.

Complément

1. 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.
2. 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.
3. 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é.
4. 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...
5. Pour faire des commentaires, c'est (malheureusement un peu long) comme en HTML: <!-- Ceci est un commentaire -->. 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!