La barra vertical es sintaxis de tabla, pero también aparece legítimamente en comandos de shell, uniones TypeScript, expresiones regulares y texto. Si una celda contiene un | sin escapar, el renderizador puede interpretarlo como el límite de otra columna.
Escapa una barra vertical literal
Añade una barra inversa justo antes:
| Expresión | Significado |
| :--- | :--- |
| `ready \| waiting` | Se acepta cualquiera de los estados |
| `string \| null` | Una unión de TypeScript |Algunos renderizadores procesan primero el código en línea; otros exigen escapar incluso la barra entre acentos graves. Escaparla es la opción más portable. Un generador debe aplicar el escape al exportar Markdown, no alterar el valor visible en el editor.
Distingue la entrada de barras inversas
Si el valor original ya contiene \|, un formateador ingenuo puede añadir otra barra cada vez. Mantén separado el valor bruto de la cuadrícula y el valor Markdown serializado: edita el texto bruto y escápalo una sola vez al exportar. Al importar una tabla existente, decodifica los escapes para editar y vuelve a codificarlos al exportar.
Gestiona los saltos de línea deliberadamente
La mayoría de implementaciones espera una línea de código por fila. Hay tres opciones prácticas:
- Sustituir el salto por un espacio si no aporta significado.
- Usar
<br>si el destino permite HTML en línea. - Mover el detalle debajo de la tabla y enlazarlo desde una celda breve.
La tercera opción suele mejorar accesibilidad y lectura móvil.
Prueba el renderizador final
GitHub, un generador estático y un portal interno pueden producir resultados distintos. Conserva una tabla mínima de prueba si las barras y el código en línea son importantes para tu documentación.
El generador visual de tablas escapa las barras al generar el resultado y no envía las celdas a un servidor.