Convertir tablas Markdown a HTML y JSON: reglas y límites

Contenido
Las tablas Markdown (sintaxis de barras verticales), las etiquetas HTML <table> y los arrays de objetos JSON solo se diferencian en la forma de representación; los datos que contienen, es decir, la fila de encabezado y las filas de valores, son los mismos. Este artículo explica con qué reglas se corresponden los tres formatos entre sí y cómo se procesa realmente una tabla cuando el número de columnas no coincide o cuando falta la línea separadora del encabezado.
Resumen ① La primera línea de una tabla Markdown es la fila de encabezado, y la presencia del carácter
-en la segunda línea determina si se trata de la línea separadora. ② En HTML se usan<th>/<td>dentro de<tr>y en JSON se usan las claves (key) del primer objeto como fila de encabezado. ③ Aunque el número de celdas varíe de una fila a otra, se rellenan automáticamente los huecos o se descarta el exceso, así que no necesitas ajustarlo a mano.
Dónde sueles atascarte al convertir tablas Markdown a HTML o JSON
Es habitual que escribas una tabla Markdown en una entrada de blog y luego tengas que pegarla como HTML en el sitio o, al contrario, que necesites convertir un array JSON devuelto por una API en una tabla Markdown para la documentación. Con una o dos tablas puedes hacerlo a mano, pero cuando pasas de varias decenas de filas es fácil cometer errores al contar la posición de las barras verticales (|) o al abrir etiquetas <td> una por una.
Cómo convertir los tres formatos a mano: solo hay una regla
Los tres formatos dividen los datos en una «fila de encabezado» y varias «filas de valores». La única diferencia entre formatos es la sintaxis que envuelve esos dos bloques.
- Markdown → HTML: convierte cada celda de la primera línea en
<th>y cada celda de las líneas siguientes (excepto la línea separadora) en<td>, y envuelve cada línea en<tr>. - HTML → Markdown: convierte cada
<tr>en una línea, separa con|los valores de<td>/<th>que contiene y añade una línea separadora con el formato|---|---|justo debajo de la fila de encabezado. - JSON → Markdown/HTML: los nombres de las claves del primer objeto del array pasan a ser la fila de encabezado, y los valores de cada objeto forman una fila en el orden de esas claves.
Con estas tres reglas puedes convertir cualquier número de tablas a mano, pero cuantas más filas haya, más fácil es equivocarse. Justo debajo puedes usar el Convertidor Cruzado de Tablas Markdown ↔ HTML ↔ JSON, que aplica estas mismas reglas en cuanto pegas el contenido y te muestra al mismo tiempo los otros dos formatos.
Pega en el campo de entrada el código de una tabla Markdown, las etiquetas HTML o los datos JSON y comprueba al instante el resultado en los otros formatos.

Puntos que suelen darte problemas
| Situación | Cómo se procesa realmente |
|---|---|
No hay línea separadora (-) en la segunda línea de Markdown | No se reconoce como separador y la segunda línea pasa a ser una fila de datos más, tal cual |
| El número de celdas cambia de una fila a otra | Si faltan celdas respecto a la fila de encabezado, se rellenan con una cadena vacía; si sobran, se descarta el exceso |
En HTML, la fila de encabezado (<th>) y las filas del cuerpo (<td>) están separadas | La fila de encabezado se reconoce correctamente, pero el <tr> que contenía los encabezados puede volver a aparecer como primera fila de datos, así que conviene comprobar si la primera línea del resultado repite el texto del encabezado |
| Cada objeto del array JSON tiene una estructura de claves distinta | Solo las claves del primer objeto se usan como fila de encabezado; los valores de las claves que solo existen en otros objetos no se reflejan en el resultado |
En resumen
Los tres formatos no son más que la misma estructura —fila de encabezado + filas de valores— expresada con sintaxis distintas. Al convertirlos a mano basta con respetar estas reglas de correspondencia, y el convertidor las aplica automáticamente con cada entrada para mostrar el resultado. Aun así, en los casos que suelen dar problemas —la presencia o ausencia de la línea separadora del encabezado, las diferencias en el número de celdas o la duplicación de la fila de encabezado en HTML— es más seguro revisar el resultado a simple vista siguiendo la tabla anterior.
Pega en el campo de entrada el código de una tabla Markdown, las etiquetas HTML o los datos JSON y comprueba al instante el resultado en los otros formatos.
Preguntas frecuentes
¿Puedo usar celdas combinadas (rowspan y colspan)?
Los tres formatos solo trabajan con una «fila de encabezado» y «filas de valores», así que no admiten celdas combinadas. Debes deshacer la combinación, rellenar el valor en cada celda y luego introducirlo.
¿Qué hago si el resultado de la conversión repite el contenido de la fila de encabezado?
Si la entrada HTML tiene un <tr> con <th> aparte para el encabezado, esa línea puede aparecer otra vez como fila de datos (consulta la tabla anterior). Basta con eliminar esa línea del resultado de la conversión.
¿Puedo incluir saltos de línea o el carácter | dentro de una celda?
En el formato Markdown, | es el propio separador de celdas, así que si incluyes una barra vertical dentro de una celda, la tabla se dividirá mal. Un salto de línea también se interpreta como una línea nueva y rompe la tabla, por lo que es más seguro no incluirlos en el valor.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano