Markdown - Mémo des balises

A quoi sert Markdown

Markdown est un langage de balisage léger : on écrit du texte brut avec quelques symboles, et il est converti en HTML mis en forme. Pas de bouton “gras” à cliquer, juste **gras**.

C’est devenu le format par défaut pour à peu près tout ce qu’un admin système écrit : ce blog, les README GitHub, la documentation Ansible, les tickets GitLab, Obsidian, Slack (en partie)… Autant connaître les balises de base plutôt que de les redécouvrir à chaque fois.

Ce mémo couvre la syntaxe CommonMark (le standard) et quelques extensions GFM (GitHub Flavored Markdown) largement supportées, dont celles utilisées sur ce site.

Titres

# Titre 1
## Titre 2
### Titre 3
#### Titre 4

Six niveaux disponibles (# à ######). Sur ce blog, les articles démarrent à ### pour rester en dessous du titre de page généré automatiquement.

Emphase

*italique* ou _italique_
**gras** ou __gras__
***gras italique***
~~barré~~

Listes

Liste à puces :

- Premier élément
- Deuxième élément
  - Sous-élément (indentation de 2 espaces)
- Troisième élément

Liste numérotée :

1. Premier élément
2. Deuxième élément
3. Troisième élément

Liste de tâches (extension GFM) :

- [x] Tâche terminée
- [ ] Tâche à faire

Liens et images

[Texte du lien](https://exemple.com)
[Texte du lien](https://exemple.com "Titre au survol")
![Texte alternatif](/images/logo.jpg)

Un lien “nu” peut aussi être écrit entre chevrons pour être cliquable sans texte de remplacement :

<https://exemple.com>

Citations

> Une citation.
>
> Sur plusieurs lignes.
>
>> Citation imbriquée.

Code

Code en ligne avec des simples backticks :

Utiliser la commande `grep` pour filtrer.

Bloc de code avec triple backticks, en précisant le langage pour la coloration syntaxique :

```bash
grep -E '^[0-9]' toto.txt
```

Tableaux

| Colonne 1 | Colonne 2 | Colonne 3 |
|-----------|:---------:|----------:|
| Gauche    | Centré    | Droite    |
| a         | b         | c         |

Les : autour des tirets définissent l’alignement (gauche, centré, droite).

Séparateurs

---
***
___

Les trois syntaxes produisent une ligne horizontale.

Échappement de caractères

Pour afficher un caractère spécial sans qu’il soit interprété, le faire précéder d’un \ :

\*pas en italique\*

Alertes / admonitions

Extension GitHub (blockquote spécial), supportée par le thème de ce site :

> [!NOTE]
> Information complémentaire.

> [!TIP]
> Astuce.

> [!IMPORTANT]
> Information à ne pas manquer.

> [!WARNING]
> Attention, point sensible.

> [!CAUTION]
> Risque de conséquence négative.

D’autres types existent selon le thème (info, success, question, danger, bug, example, quote) mais NOTE/TIP/IMPORTANT/WARNING/CAUTION sont les cinq standards GFM, donc les plus portables.

Tableau récapitulatif

Rappel : la syntaxe de base (CommonMark) est standard partout. Les extensions comme les listes de tâches, le barré ou les alertes dépendent du moteur de rendu (GitHub, GitLab, ce site…) et ne s’affichent pas forcément à l’identique ailleurs.