====== Cours Complet : Apprendre Markdown ======

Cette page documente la syntaxe standard Markdown (CommonMark / GitHub Flavored Markdown).
Version originale: https://www.it-connect.fr/apprendre-a-ecrire-en-markdown/

===== 1. Titres =====
<code text>
# Titre H1
## Titre H2
### Titre H3
#### Titre H4
</code>

===== 2. Formatage de texte =====
<code text>
**Texte en gras**
*Texte en italique* ou _Texte en italique_
***Gras et italique***
~~Texte barré~~
</code>

===== 3. Listes =====

==== Listes à puces ====
<code text>
* Élément 1
* Élément 2
  * Sous-élément (indentation de 2 espaces)
- Autre puce (le tiret fonctionne aussi)
</code>

==== Listes numérotées ====
<code text>
1. Premier élément
2. Deuxième élément
   1. Sous-élément numéroté (indentation de 3 espaces minimum)
</code>

==== Listes de tâches (Task lists) ====
<code text>
- [ ] Tâche à faire
- [x] Tâche terminée
</code>

===== 4. Liens et Images =====

==== Liens ====
<code text>
[Texte du lien](https://commonmark.org)
</code>

==== Images ====
<code text>
![Texte alternatif](https://chemin/vers/image.png)
</code>

===== 5. Citations (Blockquotes) ====
<code text>
> Ceci est une citation.
> Elle peut s'étendre sur plusieurs lignes.
>> Et inclure des sous-citations.
</code>

===== 6. Code =====

==== Code en ligne ====
<code text>
Pour lister les fichiers, utilisez un backtick (accent grave) avant et après :
`ls -la`
</code>

==== Blocs de code ====
<code text>
Pour un bloc de code multiligne, on utilise trois backticks au début et à la fin :
[3 backticks]bash
#!/usr/bin/env zsh
# Script d'exemple
for file in *; do
    echo $file
done
[3 backticks]
(Remplacez [3 backticks] par les trois accents graves `` ``` `` sans le parser markdown global)
</code>

===== 7. Tableaux =====
<code text>
| En-tête 1 | En-tête 2 | En-tête 3 |
| :---      | :---:     | ---:      |
| Gauche    | Centré    | Droite    |
| Valeur    | Valeur    | Valeur    |
</code>

===== 8. Échapper des caractères =====
<code text>
Pour afficher des caractères utilisés par Markdown sans les interpréter, utiliser un backslash :
\*Ce texte ne sera pas en italique\*
</code>

===== Références & Outils =====
  * Spécification CommonMark : https://commonmark.org/
  * Guide de référence complet : https://www.markdownguide.org/
  * Plugin Neovim pour la prévisualisation Markdown en direct : https://github.com/iamcco/markdown-preview.nvim