17 — Markdown avancé

Le chapitre 06 couvre les bases. Celui-ci rassemble les extras que ce serveur rend également — tous essayés sur cette installation.

Listes de tâches

- [x] brouillon écrit
- [ ] en attente de relecture

Fonctionne dans les tickets et les fichiers .md ; les cases sont affichées en lecture seule.

Codes emoji

:tada: :rocket: :warning:

Donne 🎉 🚀 ⚠️. Coller l'emoji directement marche aussi.

Notes de bas de page

Cette affirmation a une source[^1]

[^1]: D'où vient l'affirmation.

Un chiffre en exposant apparaît dans le texte, et la note liée en bas de page.

Mathématiques

En ligne $E = mc^2$, ou en bloc :

```math
\frac{a}{b} = c
```

Les formules sont composées dans le navigateur ; la source reste du texte, donc git diff reste lisible.

Diagrammes

```mermaid
graph TD
  A[Demande] --> B{Approuvé ?}
  B -- oui --> C[Fusionner]
  B -- non --> D[Corriger]
```

Diagrammes de flux, de séquence et de Gantt dessinés depuis du texte. Comme aucun fichier image n'est nécessaire, le diagramme entre lui aussi dans l'historique — la modification se lit dans git diff.

Tableaux, barré, liens automatiques

| Colonne | Signification |
|---------|---------------|
| `main`  | branche par défaut |

~~abandonné~~ et une adresse nue : https://forge.kabaforce.com

Une adresse devient un lien même sans crochets.

Faire référence à un ticket ou à quelqu'un

Dans les tickets et les commentaires :

• #12 → lien vers ce ticket
• @utilisateur → lien vers la personne, avec notification
• Fixes #12 dans le résumé d'un commit → ferme le ticket quand la modification arrive sur main (chapitre 11)

Où fonctionne quoi

Deux habitudes à garder

• Utilisez l'onglet Aperçu — avant de commiter, vous voyez exactement ce que verront les autres.
• Une phrase par ligne dans les longs documents — les différences se lisent ligne à ligne au lieu de colorer tout un paragraphe.