🔍 Le "balisage léger"

Le Markdown est un langage de balisage léger. Concrètement :

• Vous écrivez votre texte avec quelques signes simples au milieu (astérisques, dièses, tirets…).
• Ces signes ne perturbent pas la lecture du texte brut.
• Un convertisseur transforme automatiquement vos signes en mise en forme (gras, italique, titres, listes…).

Balisage léger : par opposition au HTML (qui demande d'écrire <strong>texte</strong> pour mettre en gras), le Markdown se contente de **texte**. Plus court, plus lisible, plus rapide à taper.

Vocabulaire : Il ne faut pas confondre les langages de "Markup" (balisage), comme le HTML, le XML… et le "Markdown", langage spécifique de balisage léger.

🔧 Vocabulaire

Le Markdown : la syntaxe légère qui structure vos contenus

✍️ La syntaxe de base

Voici l'essentiel à connaître, idéal pour saisir vos notes dans Obsidian par exemple (voir encadré) et structurer des protocoles pour des IA.

Les titres

Le dièse # crée des titres, du plus grand au plus petit :

# Titre principal (H1)
## Titre de section (H2)
### Sous-titre (H3)
#### Sous-sous-titre (H4)
##### H5
###### H6

Bonne pratique : un seul H1 par document, puis H2 pour les grandes parties, H3 pour les sous-parties.

Important : toujours mettre un espace après le #

Le gras et l'italique

• Texte en gras : **texte** ou __texte__
• Texte en italique : *texte* ou _texte_
• Gras + italique : ***texte***
• Texte barré (extension GFM) : ~~texte~~

Les listes à puces

- Premier élément
- Deuxième élément
  - Sous-élément (indenté de 2 espaces)
  - Autre sous-élément
- Troisième élément

Les listes numérotées

1. Première étape
2. Deuxième étape
3. Troisième étape

Astuce — vous pouvez mettre 1. partout, l'éditeur recompte automatiquement à l'affichage.

Les cases à cocher (extension GFM)

- [ ] Tâche à faire
- [x] Tâche faite

Les liens

[Texte du lien](https://exemple.com)
[Lien avec titre infobulle](https://exemple.com "Titre")

Les images

Même syntaxe que les liens, précédée d'un point d'exclamation :

![Texte alternatif](chemin/vers/image.jpg)
![Logo Boomerang](https://boomerang-formation.com/logo.png "Logo")

Les citations

Le signe > en début de ligne crée un bloc de citation. Vous pouvez les imbriquer.

> Ceci est une citation.
> Elle peut tenir sur plusieurs lignes.
>
> > Et imbriquer une autre citation à l'intérieur.

Le code

Inline (au milieu d'une phrase) — entourez de backticks simples :

Tapez la commande `git status` pour voir les modifications.

Bloc complet (plusieurs lignes) — trois backticks avant et après :

```
function bonjour() {
  console.log("Hello world");
}
```

Bloc avec coloration syntaxique — précisez le langage après les trois backticks :

```javascript
function bonjour() {
  console.log("Hello world");
}
```

Les tableaux (extension GFM)

| Colonne 1 | Colonne 2 | Colonne 3 |
|---|---|---|
| Cellule 1 | Cellule 2 | Cellule 3 |
| Cellule A | Cellule B | Cellule C |

Vous pouvez aligner les cellules avec :--- (gauche), :---: (centre), ---: (droite).

Les séparateurs

Trois tirets, trois astérisques ou trois underscores sur une ligne : ---, *** ou ___. Sépare visuellement deux sections.

Les sauts de ligne et paragraphes

• Saut de paragraphe : laissez une ligne vide entre deux blocs.
• Saut de ligne dans un paragraphe : terminez la ligne par deux espaces puis retour ligne, ou utilisez <br>.

🚀 La syntaxe étendue — pour aller un cran plus loin

Une fois la base maîtrisée, voici quelques extensions très utiles selon votre outil.

Notes de bas de page

Ceci est une assertion[^1] qu'on va sourcer plus loin.
[^1]: Source : Bridge Collet, mai 2026.

Front matter YAML

Utilisé par Obsidian, Hugo, Jekyll, Astro… pour ajouter des métadonnées en tête de fichier :

---
title: Mon article
author: Bridge
date: 2026-05-06
tags: [seo, aeo, schema]
---
Le contenu de l'article commence ici.

Le bloc entre les --- n'apparaît pas dans le rendu visuel — il sert aux outils pour trier, filtrer ou afficher des informations.

Liens internes (Linked Markdown — Obsidian, Logseq)

Voir aussi [[autre-note]] pour plus de détails.
Et avec un libellé personnalisé : [[autre-note|texte affiché]]

Ces liens internes ne sont pas standard CommonMark. C'est une extension d'Obsidian, Logseq et autres outils de PKM. Mais c'est ce qui transforme un dossier de notes en wiki personnel — extrêmement puissant.

Callouts (Obsidian, Notion, plus en plus de plateformes)

> [!note]
> Ceci est une note importante à retenir.
> [!warning]
> Ceci est un avertissement.
> [!tip]
> Ceci est un conseil.

Affichés sous forme de blocs colorés en mode lecture.