Débuter avec Markdown : Un guide pour débutants

Markdown est l'un des langages de balisage les plus polyvalents et les plus utilisés au monde. Que vous rédigiez des fichiers README sur GitHub, preniez des notes dans Obsidian ou écriviez des articles de blog, Markdown vous permet de formater du texte rapidement sans quitter le clavier.

Ce que vous allez apprendre

Dans ce guide, nous aborderons la syntaxe Markdown essentielle que vous utiliserez au quotidien :

• Titres — Structurez votre document avec six niveaux de titres
• Mise en forme du texte — Gras, italique et barré
• Listes — Listes ordonnées et non ordonnées
• Liens et images — Intégrer des médias
• Code — Code en ligne et blocs de code
• Citations — Citer du texte

Votre premier document Markdown

Commencez par quelque chose de simple. Créez un fichier appelé hello.md et ajoutez :

# Hello, Markdown!

This is my **first** Markdown document.

- Item one
- Item two
- Item three

La plupart des éditeurs et des plateformes (GitHub, Notion, VS Code) afficheront automatiquement ceci sous forme de texte formaté.

Titres

Utilisez les symboles # pour créer des titres. Un seul # donne le titre le plus grand ; six ###### donnent le plus petit.

# Heading 1
## Heading 2
### Heading 3

Mise en forme du texte

Mettez le texte en gras en l'entourant de doubles astérisques **comme ceci**, ou en italique avec des astérisques simples *comme ceci*. Combinez les deux pour du gras italique.

Listes

Créez des listes non ordonnées avec -, * ou + :

- First item
- Second item
- Third item

Pour les listes ordonnées, numérotez simplement les éléments :

1. First step
2. Second step
3. Third step

Prochaines étapes

Une fois à l'aise avec les bases, explorez des fonctionnalités plus avancées :

• Les tableaux pour les données structurées
• Les listes de tâches pour suivre la progression
• Les blocs de code avec la coloration syntaxique
• Les équations mathématiques avec KaTeX