Markdown

Un pense-bête (ou cheat sheet) des mises en forme Markdown que j'utilise le plus avec MkDocs et le thème Material. Pour plus de ressources, voir les sites suivants :

• Implémentation originale de John Gruber : https://daringfireball.net/projects/markdown/
• Implémentation Python-Markdown (utilisée par MkDocs) : https://python-markdown.github.io/
• Différences entre ces deux versions : https://python-markdown.github.io/#differences
• Extensions Python-Markdown : https://python-markdown.github.io/extensions/
• Documentation du thème Material : https://squidfunk.github.io/mkdocs-material/setup/

Titres

# Titre de niveau 1
## Titre de niveau 2
### Titre de niveau 3

Gras et italique

**Texte en gras**
_Texte en italique_
**_Texte en gras et en italique_**

Citation

> Ceci est une citation.

Liste ordonnée

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

Liste non ordonnée

- Premier élément
- Deuxième élément
- Troisième élément

Code

`Ceci est une ligne de code en ligne`

Un bloc de code est encadré par deux lignes de ```
La première ligne peut spécifier le langage utilisé, par exemple ```python

Ligne horizontale

---

Lien

[Texte à afficher](lien)

Image

![Texte alternatif](lien_vers_l_image)

Tableau

| Ville | Pays |
| ----------- | ----------- |
| Paris | France |
| Rome | Italie |

Admonitions

Avertissement

!!! warning

    Ceci est un message d'avertissement.

Note

!!! note "Note avec un titre"

    Ceci est une note avec un titre.

Astuce

!!! tip "Astuce"

    Ceci est une astuce.

Danger

!!! danger "Danger"

    Ceci signale un danger.