Comment utiliser Markdown (CommonMark) dans notre wiki

Remarque : Ce document est une traduction automatique de la version originale anglaise.

Cette page est un court "aide-mémoire" pour le formatage des pages de notre wiki, où le contenu est rédigé en CommonMark Markdown.

Règles de base

• Rédigez des phrases simples et courtes.
• Rendez la page facile à parcourir : titres + listes + tableaux.
• Une section = une idée. Évitez les "murs de texte".

Titres

Utilisez ## / ### / #### pour la structure.

## Section
### Sous-section
#### Sous-sous-section

Gras, italique, code en ligne

**gras**
*italique*
`code/champ/adresse`

Liens

[texte du lien](https://example.com)

Si vous devez afficher un lien "brut" (rare) :

`https://example.com`

Listes

Liste à puces :

- élément 1
- élément 2
  - sous-élément

Liste numérotée :

1. étape 1
2. étape 2
3. étape 3

Citations / notes

> C'est une note importante.
> Elle peut s'étendre sur deux lignes.

Tableaux

Modèle minimal :

| Champ | Valeur |
|---|---|
| Nom | [ ] |
| Statut | [ ] |

Astuces :

• La ligne de séparation |---|---| est obligatoire.
• Les cellules du tableau peuvent contenir du **gras**, des liens et du code.

Blocs de code et de texte "brut"

Bloc de code :

\```text
ligne 1
ligne 2
\```

S'il s'agit d'un langage spécifique (par exemple, JSON), vous pouvez le préciser :

\```json
{ "clé": "valeur" }
\```

Images

Si vous avez une URL directe vers l'image :

![description](https://example.com/image.png)

Si le fichier est téléchargé sur le wiki, utilisez le lien/code d'intégration fourni par le wiki lors du téléchargement.

Sauts de ligne et paragraphes

• Un nouveau paragraphe correspond à une ligne vide entre les paragraphes.
• Si vous avez besoin d'un saut de ligne à l'intérieur d'un paragraphe, ajoutez deux espaces à la fin de la ligne :

Première ligne.  
Deuxième ligne.

HTML intégré (à utiliser avec précaution)

Bloc "Détails" pliable

Utilisez-le pour les longs détails/preuves afin d'éviter de surcharger le "premier écran".

<details>
<summary><b>Détails</b></summary>

Vous pouvez placer du texte, des listes et des tableaux ici.

</details>

Ancres et liens rapides au sein d'une page

Ancre :

<a id="ai-thesis-fit"></a>

Lien vers l'ancre :

[Aller à l'adéquation avec la thèse IA](#ai-thesis-fit)

Espaces réservés dans les modèles

Dans les modèles, nous utilisons :

• [ ] — "à remplir"
• — / — — "— / non applicable" (lorsque cela a du sens)
• YYYY‑MM‑DD — format de date
• Tier‑1/2/3 — niveau de la source (preuve/contexte/bruit)

Erreurs courantes

• Mélanger infobox et description : l'infobox ne contient que des faits brefs ; les explications vont dans le corps de la page.
• Rédiger sans sources là où une source devrait exister.
• Surcharger le "premier écran" : les détails longs sont mieux placés dans <details>.
• Utiliser un "langage financier" (conseils d'achat/vente/conservation, prévisions) — cela nous est interdit ; nous décrivons des faits/risques/ce qu'il faut vérifier.

Mini liste de contrôle avant publication

• Y a-t-il 1 ou 2 lignes qui expliquent "ce que c'est" ?
• Y a-t-il des liens vers des sources primaires ?
• Y a-t-il des champs de tableau "peu clairs" vides (chacun doit être soit une valeur, soit —/—) ?
• La section Last verified (Dernière vérification) est-elle remplie ?