Découvrir le Markdown — la syntaxe qui vous suivra partout

Le Markdown est un langage de balisage léger qui permet de mettre en forme du texte avec quelques symboles simples (*, #, [ ], etc.). Vous le retrouverez partout : Notebooks Capytale, GitHub, HedgeDoc, Notion, et même ce blog.

Le Markdown est un format texte brut. Vous pouvez sauvegarder votre travail dans un simple fichier .md ou .txt — il restera lisible dans trente ans, sans logiciel propriétaire.

Mise en forme courante

Objectif	Code
Texte en gras	`gras` ou `__gras__`
Texte en italique	`italique` ou `_italique_`
Texte en gras et italique	`*gras et italique*`
Lien vers un site	`[libellé](https://nsi.rocks)`
Image	`![texte alternatif](url-image.png)`

Le texte alternatif d'une image sert à deux choses : indiquer le contenu en cas de lien cassé, et permettre aux lecteurs malvoyants d'accéder à l'information via une synthèse vocale. Ne le négligez pas.

Listes

Les listes non ordonnées utilisent un tiret. Indentez de deux espaces pour imbriquer.

- item
  - sous-item
  - sous-item
- item

Les listes ordonnées utilisent des chiffres :

1. premier point
2. deuxième point
3. troisième point

Titres

Le nombre de # détermine le niveau du titre — du plus important (#) au plus discret (######).

# Titre principal
## Sous-titre
### Niveau 3

Insérer du code

Pour un bloc de code, encadrez-le par trois backticks. Précisez le langage juste après le premier groupe pour bénéficier de la coloration syntaxique.

```py
def addition(a, b):
    return a + b
```

Sur un clavier AZERTY classique, le backtick (`) s'obtient avec AltGr + 7 sous Windows, et Option + è sur macOS.

Aller plus loin

Le Markdown reconnaît aussi les citations (>), les tableaux, les séparateurs (---), les cases à cocher (- [ ]). Apprenez la base, le reste viendra naturellement à l'usage.