Mémo de syntaxe Markdown
Tout ce que vous pouvez écrire dans l’éditeur, et ce que chaque balise devient une fois exportée en Word ou en PDF.
Les balises en un coup d’œil
| Élément | Ce qu’on écrit | Remarque |
|---|---|---|
| Titre de niveau 1 | # Mon titre | Un seul par document |
| Titre de niveau 2 à 6 | ## Section | Jusqu’à ###### pour le niveau 6 |
| Gras | **important** | Ou __important__ |
| Italique | *nuance* | Ou _nuance_ |
| Barré | ~~annulé~~ | Extension GitHub, prise en charge |
| Code en ligne | `npm run build` | Accents graves |
| Bloc de code | ```js … ``` | Le langage après les accents est facultatif |
| Lien | [libellé](https://exemple.fr) | Fonctionne aussi dans une liste |
| Image |  | Le texte alternatif est repris à l’export |
| Liste à puces | - premier | Le tiret, l’astérisque ou le plus |
| Liste numérotée | 1. premier | Démarre au numéro que vous écrivez |
| Sous-liste | - imbriqué | Deux espaces au minimum — voir ci-dessous |
| Citation | > texte cité | Un chevron par ligne |
| Séparateur | --- | Trois tirets sur une ligne seule |
| Tableau | | A | B | | Voir la section dédiée |
Le piège de l’indentation des sous-listes
C’est l’erreur la plus fréquente, et elle est silencieuse : une sous-liste indentée d’unseul espace n’est pas une sous-liste. La norme CommonMark demande que l’élément imbriqué atteigne la colonne où commence le texte du parent — soit deux espacesaprès un tiret et son espace.
| Écrit | Résultat |
|---|---|
- parent - enfant | Deux éléments au même niveau |
- parent - enfant | Une sous-liste, correctement imbriquée |
L’aperçu de l’éditeur applique exactement la même règle que les exports Word et PDF : si une sous-liste ne s’imbrique pas à l’écran, elle ne s’imbriquera pas non plus dans le fichier téléchargé. Ce qui se voit se vérifie donc immédiatement, sans exporter.
Tableaux et alignement
La ligne de séparation sous l’en-tête définit l’alignement de chaque colonne. Les deux-points indiquent le bord vers lequel le texte est poussé :
| Produit | Quantité | Prix |
| :--------- | :------: | -----: |
| Classeur | 12 | 4,90 €|
| Stylo | 120 | 0,80 €|:--- aligne à gauche, :---: centre, ---: aligne à droite. L’alignement est conservé dans le document Word comme dans le PDF. Une cellule laissée vide reste une cellule vide : les colonnes suivantes ne se décalent pas.
Ce que le Markdown ne fait pas
Le Markdown ne gère ni les couleurs, ni les polices, ni les tailles de caractères, ni les colonnes, ni les en-têtes et pieds de page. C’est volontaire : il décrit unestructure — « ceci est un titre », « ceci est une liste » — et laisse le rendu à l’outil qui l’affiche. C’est aussi ce qui permet au même texte de devenir un document Word, un PDF ou une page web sans être réécrit.
Si vous avez besoin d’une mise en page précise, exportez en .docx et terminez la mise en forme dans Word : la structure sémantique que vous avez écrite y est déjà appliquée sous forme de styles natifs, ce qui rend la reprise beaucoup plus rapide qu’à partir d’une page blanche.