Pourquoi mon tableau a-t-il été refusé ?

Sans doute à cause d’une ligne de séparation courte. Jusqu’à l’écriture de cette page, l’outil voulait au moins trois tirets par cellule, quand GFM en demande un : `| :-: |` et `| - |` sont des tableaux que GitHub rend et que l’outil écartait par « Expected a Markdown table ». Un tiret suffit désormais, et les deux-points d’alignement sont lus puis oubliés — le CSV n’a pas d’alignement à porter.

Mon document a plusieurs tableaux. Lequel est pris ?

Le premier, et depuis l’écriture de cette page le premier vrai : un tableau montré dans un bloc de code — la documentation d’un format, le plus souvent — est sauté plutôt que pris. La prose autour du tableau est ignorée dans les deux cas, vous pouvez donc coller un README entier.

Qu’advient-il des cellules ?

Un pipe échappé (`\|`) redevient un pipe, les espaces autour d’une cellule disparaissent, et le Markdown en ligne reste tel qu’écrit : `**gras**` arrive en `**gras**`, le CSV n’ayant pas de gras. Une ligne plus courte que l’en-tête est complétée par des champs vides, une plus longue élargit le tableau, et le délimiteur est au choix.

Tableau Markdown en CSV — vers un tableur

Extrayez en CSV le premier tableau GFM d’un document Markdown. Ce qui était un tableau de README s’ouvre dans Excel ou Google Sheets, et se trie.

Instantané Privé Zéro cookie

Ce que fait cet outil

Un document Markdown entre, le CSV de son premier tableau sort.

De la prose, puis le tableau.

| Nom | Rôle |
| --- | --- |
| Ada | Autrice |
| Grace | Compilateur |

Nom,Rôle
Ada,Autrice
Grace,Compilateur

Les guillemets sont posés là où il en faut : une cellule contenant une virgule, un guillemet ou un saut de ligne ressort entre guillemets, et le fichier s’ouvre correctement dans un tableur. Le délimiteur est une option — un point-virgule là où c’est ce qu’attend le tableur.

Tout séparateur que GFM accepte

| Nom | Score |
| :-- | --: |
| Ada | 10 |

Nom,Score
Ada,10

GFM demande un tiret par cellule dans la ligne de séparation, avec des deux-points facultatifs pour l’alignement. Cet outil en voulait trois : un | :-: | ou un | - | parfaitement ordinaire recevait « Expected a Markdown table » — un tableau que GitHub rend, refusé. C’était un vrai défaut, trouvé en écrivant cette page puis corrigé. Les deux-points sont lus puis oubliés : le CSV n’a pas d’alignement à porter.

Le premier tableau, pas le premier exemple

La documentation montre des tableaux dans des blocs de code, et l’outil prenait l’exemple plutôt que les données :

L’en-tête s’écrit ainsi :

```
| a |
| --- |
```

| Nom | Rôle |
| --- | --- |
| Ada | Autrice |

Les blocs clôturés sont maintenant sautés : ce document vous rend Nom,Rôle. Il rendait a avant. La prose autour d’un tableau est ignorée dans les deux cas, coller un README entier ne pose donc pas de problème.

Ce que le CSV ne peut pas porter

Un seul tableau. Le premier du document, pas tous. Découpez celui qu’il vous faut s’il n’est pas en tête.
Aucune mise en forme. **gras**, `code` et liens restent dans la cellule exactement tels qu’écrits : le CSV n’a pas de quoi les rendre.
Aucun alignement. Les deux-points de la ligne de séparation sont lus puis oubliés.
Les lignes irrégulières. Une ligne à moins de cellules que l’en-tête est complétée par des champs vides ; une ligne plus longue élargit le tableau plutôt que de perdre quoi que ce soit.

Confidentiel par conception

Tout s’exécute localement dans votre navigateur en JavaScript. Vos données ne sont jamais envoyées sur un serveur, ce qui rend l’outil sûr pour des contenus sensibles, et il fonctionne hors ligne.

Questions fréquentes

Pourquoi mon tableau a-t-il été refusé ?: Sans doute à cause d’une ligne de séparation courte. Jusqu’à l’écriture de cette page, l’outil voulait au moins trois tirets par cellule, quand GFM en demande un : `| :-: |` et `| - |` sont des tableaux que GitHub rend et que l’outil écartait par « Expected a Markdown table ». Un tiret suffit désormais, et les deux-points d’alignement sont lus puis oubliés — le CSV n’a pas d’alignement à porter.
Mon document a plusieurs tableaux. Lequel est pris ?: Le premier, et depuis l’écriture de cette page le premier vrai : un tableau montré dans un bloc de code — la documentation d’un format, le plus souvent — est sauté plutôt que pris. La prose autour du tableau est ignorée dans les deux cas, vous pouvez donc coller un README entier.
Qu’advient-il des cellules ?: Un pipe échappé (`\|`) redevient un pipe, les espaces autour d’une cellule disparaissent, et le Markdown en ligne reste tel qu’écrit : `**gras**` arrive en `**gras**`, le CSV n’ayant pas de gras. Une ligne plus courte que l’en-tête est complétée par des champs vides, une plus longue élargit le tableau, et le délimiteur est au choix.