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

PublicadoHerramientaConvertidor Cruzado de Tablas Markdown ↔ HTML ↔ JSON

Contenido
  1. Dónde sueles atascarte al convertir tablas Markdown a HTML o JSON
  2. Cómo convertir los tres formatos a mano: solo hay una regla
  3. Puntos que suelen darte problemas
  4. En resumen
  5. Preguntas frecuentes

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.

Convertidor Cruzado de Tablas Markdown ↔ HTML ↔ JSON

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ónCómo se procesa realmente
No hay línea separadora (-) en la segunda línea de MarkdownNo 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 otraSi 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 separadasLa 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 distintaSolo 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.

Convertidor Cruzado de Tablas Markdown ↔ HTML ↔ JSON

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

Artículos relacionados

  1. Unir archivos de texto: cómo hacerlo sin romper la codificaciónAprende a combinar varios archivos TXT en uno solo, con orden, delimitadores y encabezados, y a evitar que el texto se vea mal por culpa de EUC-KR.
  2. Datos de prueba Mock JSON: cómo generarlos y testear la APIAprende a generar arrays JSON falsos con IDs, UUID, emails y fechas aleatorias, y a simular latencia de red para probar tu API con datos de prueba.
  3. Código morse con audio: fórmula de tiempos y Web Audio APIAprende la fórmula estándar de duración del código morse (punto 1 unidad, raya 3) y cómo generar pitidos con la Web Audio API en el navegador.
  4. Código morse: tabla de letras, números y cómo decodificarloAprende la tabla de letras y números en código morse, las reglas para separar letras y palabras y cómo convertir texto a morse y morse a texto paso a paso.
  5. Iniciales de nombres en inglés: cómo extraerlas y darles formatoAprende a extraer iniciales de nombres en inglés: orden de nombre y apellido, mayúsculas y puntos, y genera varias a la vez con nuestra herramienta.
  6. Conversión de bases numéricas: binario, octal, decimal y hexadecimalAprende a convertir entre binario, octal, decimal y hexadecimal, a usar toString y parseInt en JavaScript y por qué aparecen errores de coma flotante.

Herramientas relacionadas