Tabla Markdown a JSON

Cómo funciona realmente la conversión

GitHub-flavoured Markdown define una tabla como tres partes: una fila de encabezado con nombres de columna, una fila delimitadora con guiones y cero o más filas de cuerpo. La fila delimitadora no es decoración — en GFM es lo que convierte la línea anterior en una tabla. El convertidor recorre las partes en orden:

• Normalizar: las tuberías iniciales y finales son opcionales en GFM y se toleran aquí; los espacios en blanco alrededor de cada celda se recortan antes de que ocurra cualquier otra cosa.
• Dividir: las celdas se dividen en tuberías no escapadas; una tubería con barra invertida (\|) se convierte en un carácter | literal dentro del valor.
• Mapear: la fila de encabezado proporciona las claves de objeto en orden de columna y cada fila de cuerpo se convierte en un objeto con esas claves.
• Forzar: cada celda recortada se infiere como un número, un booleano o nulo; todo lo demás permanece como una cadena, incluida cualquier celda envuelta en comillas dobles, que opta por no participar en la inferencia.

Inferencia de tipos, explicada claramente

Una celda de tabla no tiene un sistema de tipos, por lo que el convertidor debe elegir uno, y la honestidad significa decir dónde puede fallar. Las reglas se aplican al texto de la celda recortada, en este orden:

Las dos últimas filas son las famosas. Un código postal, número de teléfono o código de producto escrito como número se convierte en un número, y un cero inicial no puede sobrevivir al viaje. Para mantener un valor literal, envuelve la celda en comillas dobles en el Markdown y el convertidor la mantiene como cadena. El compromiso es deliberado: todo como cadena ahorraría el código postal y rompería silenciosamente a cada consumidor que espera números reales.

Cómo se ve la salida

El ejemplo a continuación es el par exacto que produce el botón Cargar muestra: una tabla de cuatro columnas con un número, un booleano y una celda vacía. La celda de notas vacía en el segundo registro se convierte en un nulo explícito en lugar de una cadena vacía, por lo que la distinción que hizo el autor de la tabla sobrevive en el JSON. La salida se imprime con formato con dos espacios para mantener las diferencias legibles.

Casos límite que este convertidor rechaza en lugar de corromper

Dos entradas malformadas obtienen un error con nombre en lugar de una salida adivinada, porque cada una produciría registros que mienten:

• Sin fila delimitadora — en GFM, una línea de tuberías sin una fila de guiones debajo es un párrafo, no una tabla. Sin delimitador no hay nada en lo que confiar como encabezado, por lo que el convertidor rechaza y nombra la línea donde buscó.
• Una fila más ancha que el encabezado — las celdas adicionales no tienen clave bajo la que vivir, y GFM mismo ignora silenciosamente el exceso. Descartar datos silenciosamente es peor que un error, por lo que el convertidor informa el número de la fila ofensora. Las filas más cortas se rellenan con nulos, lo que mantiene todos los registros con la misma forma.