La barre verticale est une syntaxe de tableau, mais elle apparaît aussi dans les commandes shell, unions TypeScript, expressions régulières et textes. Un | non échappé peut être interprété comme la limite de la colonne suivante.
Échapper une barre verticale littérale
Placez un antislash juste avant :
| Expression | Signification |
| :--- | :--- |
| `ready \| waiting` | L’un ou l’autre état est accepté |
| `string \| null` | Une union TypeScript |Certains moteurs traitent d’abord les spans de code, d’autres exigent quand même l’échappement entre accents graves. Échapper est le choix le plus portable. Un générateur doit le faire lors de la sortie Markdown, sans modifier la valeur visible.
Comprendre les antislashs en entrée
Si la valeur brute contient déjà \|, un formateur naïf peut ajouter un antislash à chaque exécution. Séparez la valeur de la grille et la valeur Markdown sérialisée : échappez exactement une fois à l’export. À l’import, décodez puis réencodez les échappements.
Traiter les retours à la ligne volontairement
La plupart des implémentations attendent une ligne source par ligne de tableau. Trois choix sont pratiques :
- Remplacer le retour par un espace quand il est sans importance.
- Utiliser
<br>si le HTML inline est autorisé. - Déplacer les détails sous le tableau et créer un lien depuis une cellule courte.
La troisième option est souvent plus accessible et plus lisible sur mobile.
Tester le moteur cible
GitHub, un générateur statique et un portail interne peuvent produire des résultats différents. Conservez un tableau de test minimal si les barres et le code inline sont importants.
Le générateur visuel de tableaux échappe les barres à la sortie et ne transmet pas les cellules à un serveur.