La syntaxe de base

Un tableau en Markdown se construit avec des barres verticales | pour délimiter les colonnes, et une ligne de séparation faite de tirets --- entre l'en-tête et les données.

| Prénom  | Rôle          | Disponible |
|---------|---------------|------------|
| Alice   | Coordinatrice | Oui        |
| Bob     | Technicien    | Non        |
| Carol   | Formatrice    | Oui        |

Quelques règles à retenir : la première ligne est toujours l'en-tête, la ligne de tirets est obligatoire, et les barres verticales au début et à la fin de chaque ligne sont optionnelles  mais les inclure rend le tableau beaucoup plus lisible en texte brut.

L'alignement des colonnes

On peut contrôler l'alignement du texte dans chaque colonne en ajoutant des deux-points : dans la ligne de séparation.

| Élément     | Quantité | Prix unitaire |
|:------------|:--------:|--------------:|
| Stylos      |    12    |         0,50€ |
| Carnets     |    5     |         3,20€ |
| Classeurs   |    3     |         4,80€ |

Les trois options sont les suivantes : :--- pour aligner à gauche (c'est le comportement par défaut), :---: pour centrer, et ---: pour aligner à droite, pratique pour les colonnes de chiffres ou de montants.

Ce que Nextcloud fait différemment

Dans Nextcloud Text, vous n'avez pas besoin de taper tout ça à la main. L'éditeur propose un bouton d'insertion de tableau dans la barre d'outils : il génère automatiquement la structure de base, et vous n'avez plus qu'à remplir les cellules.

Mieux encore : une fois le tableau créé, vous pouvez naviguer de cellule en cellule avec la touche Tab, exactement comme dans un tableur. L'éditeur gère lui-même l'alignement des barres verticales pour que le tableau reste lisible en texte brut, un détail appréciable quand on ouvre le fichier .md brut.

En revanche, Nextcloud ne supporte pas nativement les calculs ni les formules dans les cellules. Pour ça, il faudra passer par un tableur dédié. Le tableau Markdown est fait pour présenter de l'information, pas pour la calculer.

Les limites et les astuces à connaître

On ne peut pas fusionner des cellules. C'est la limite la plus frustrante du format : il n'existe pas de syntaxe Markdown pour faire l'équivalent d'un "colspan" ou "rowspan" comme en HTML. Si votre tableau nécessite des cellules fusionnées, il faudra soit reformuler sa structure, soit passer par un autre format.

On ne peut pas créer de tableau sur plusieurs niveaux. Un tableau Markdown est toujours plat : une ligne d'en-tête, des lignes de données, c'est tout. Pas de sous-groupes, pas d'arborescences.

Le texte dans les cellules reste sur une seule ligne. On ne peut pas créer de retour à la ligne à l'intérieur d'une cellule. Si vous avez besoin d'une liste dans une cellule, ce n'est pas possible nativement en Markdown standard — certains outils acceptent un contournement avec <br> en HTML, mais ce n'est pas garanti.

Pour les grands tableaux, préférez un tableur. Un tableau Markdown avec de nombreuses colonnes et lignes devient vite difficile à maintenir en texte brut. À partir d'une dizaine de colonnes ou d'une vingtaine de lignes, un fichier `.xlsx` ou un tableau Nextcloud Spreadsheet sera plus adapté.

La mise en forme fonctionne dans les cellules. On peut utiliser le gras, l'italique, les liens et même les emojis à l'intérieur des cellules : | **Important** | [Voir doc](https://...) | fonctionnera sans problème.

En résumé

Les tableaux Markdown sont parfaits pour présenter des données simples et structurées : comparatifs, listes de contacts, plannings légers, récapitulatifs. Ils sont lisibles en texte brut, portables, et Nextcloud facilite leur création avec son interface visuelle. Mais ils ont leurs limites : pas de fusion de cellules, pas de calculs, pas de mise en page complexe. Pour tout ce qui dépasse, un vrai tableur restera toujours plus adapté.

Cet article fait partie d'une série sur le Markdown et son utilisation dans Nextcloud :

- Le Markdown : un format simple et puissant, même sans être informaticien.

- Mettre en valeur l'information en Markdown : bandeaux et blocs dépliants

Ézéo est une coopérative bretonne spécialisée dans les solutions numériques libres.