L’alignement d’un tableau Markdown est codé dans la ligne séparatrice, pas dans les cellules de données. Un deux-points à gauche aligne à gauche, des deux côtés centre, et à droite aligne à droite.
Les trois formes d’alignement
| Nom | Statut | Durée |
| :--- | :----: | -------: |
| Build | Réussi | 42 s |
| Déploiement | En attente | 3 min |
L’exemple utilise :---, :---: et ---:. Le nombre de tirets est généralement flexible, mais trois ou plus offrent la meilleure portabilité. Les espaces supplémentaires servent uniquement à la lisibilité de la source.
Choisir selon le sens
La gauche convient aux noms, descriptions, URL et textes. Le centre fonctionne pour de courtes catégories comme oui/non, les icônes ou les statuts. Évitez de centrer de longues phrases. La droite aide à comparer prix, quantités, durées et pourcentages ; le contenu reste du texte, sans calcul ni tri de tableur.
Garder une source maintenable
Rembourrer les cellules pour obtenir la même largeur est facultatif :
| Clé | Valeur |
| :-- | ----: |
| A | 10 |
Si les valeurs changent souvent, utilisez un formateur. Il doit tenir compte de la largeur visuelle des emojis et caractères CJK, qui ne correspond pas toujours à la longueur d’une chaîne JavaScript.
Diagnostiquer un alignement ignoré
Si tout reste à gauche, vérifiez que la destination prend en charge les tableaux GitHub Flavored Markdown ; CommonMark seul ne définit pas les tableaux. L’en-tête et la ligne séparatrice doivent avoir le même nombre de cellules, sans barre non échappée.
Utilisez l’éditeur de tableaux Markdown pour régler chaque colonne et inspecter la ligne générée.