Annexe A — Markdown pour Jupyter

Ce guide présente les commandes Markdown les plus utiles pour structurer clairement un notebook Jupyter. Vous pouvez aussi consulter directement le tableau de référence rapide B.12.

A.1 Titres et sections

Utilisez # pour créer des titres et des niveaux de section.

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

Résultat:

B Titre de niveau 1

B.1 Titre de niveau 2

B.1.1 Titre de niveau 3

B.1.1.1 Titre de niveau 4

B.2 Mise en forme du texte

Style	Syntaxe Markdown	Résultat
Italique	`texte` ou `_texte_`	texte
Gras	`texte` ou `__texte__`	texte
*Gras et italique*	`*texte*`	*texte*
`Code dans le texte`	`code`	`code`
~~Texte barré~~	`~~texte~~`	~~texte~~

B.3 Liens et images

Lien:

[Page d’accueil du cours](../index.qmd)

Image:

![Logo de Python](https://www.python.org/static/community_logos/python-logo.png)

Le texte placé entre crochets décrit le lien ou l’image. Pour une image, ce texte alternatif reste important lorsque l’image ne peut pas être vue.

B.4 Listes

Liste non ordonnée:

- Élément 1
- Élément 2
  - Sous-élément 2.1

Résultat:

Élément 1
Élément 2
- Sous-élément 2.1

Liste ordonnée:

1. Première étape
2. Deuxième étape
   1. Sous-étape

Résultat:

Première étape
Deuxième étape
1. Sous-étape

B.5 Citations en bloc

> Ceci est une citation.

Résultat:

Ceci est une citation.

B.6 Blocs de code

Pour afficher plusieurs lignes de code avec une coloration syntaxique:

```python
def saluer(nom):
    print(f"Bonjour, {nom}!")
```

Résultat:

def saluer(nom):
    print(f"Bonjour, {nom} !")

Dans cet exemple, le code est seulement affiché. Dans un fichier Quarto, une cellule écrite avec ```{python} peut également être exécutée.

B.7 Équations mathématiques avec LaTeX

Jupyter et Quarto acceptent la syntaxe LaTeX pour écrire des expressions mathématiques.

Équation dans une ligne:

L’énergie est donnée par $E = mc^2$.

Résultat:

L’énergie est donnée par $E = mc^2$.

Équation centrée sur une ligne séparée:

$$
\int_a^b f(x)\,dx = F(b) - F(a)
$$

Résultat:

\[ \int_a^b f(x)\,dx = F(b) - F(a) \]

B.8 Indices et exposants avec LaTeX

Utilisez le mode mathématique LaTeX pour écrire proprement les indices et les exposants.

- Indice : $H_2O$
- Exposant : $x^2$
- Combinaison : $x_i^2$

Résultat:

Indice: $H_2O$
Exposant: $x^2$
Combinaison: $x_i^2$

B.9 Tableaux

| Nom   | Âge | Pays   |
|-------|-----|--------|
| Alice | 25  | Suisse |
| Bob   | 30  | France |

Résultat:

Nom	Âge	Pays
Alice	25	Suisse
Bob	30	France

B.10 Ligne horizontale

---

Résultat:

B.11 Listes de tâches

- [x] Écrire le résumé
- [ ] Ajouter les images
- [ ] Relire le notebook

Résultat:

Écrire le résumé
Ajouter les images
Relire le notebook

B.12 Tableau de référence rapide

Élément	Syntaxe Markdown	Exemple
Titre	`#`, `##`, `###`	`## Titre`
Gras	`texte`	texte
Italique	`texte`	texte
Code dans le texte	`code`	`print()`
Bloc de code	```python ... ```	code sur plusieurs lignes
Liste	`-` ou `1.`	liste à puces ou numérotée
Lien	`[titre](adresse)`	Page d’accueil du cours
Image	`![description](adresse)`	image avec texte alternatif
Mathématiques	$...$ ou `$$...$$`	formule dans le texte ou séparée
Indice ou exposant	$H_2O$ , $x^2$	$H_2O$, $x^2$
Tableau	`\| colonne \| colonne \|`	tableau mis en forme
Citation en bloc	`>`	citation mise en retrait
Ligne horizontale	`---`	séparation entre deux sections