Salida JSON
La tabla Markdown de ejemplo produce este JSON:
[
{ "Name": "Alice", "Age": "30", "City": "Istanbul" },
{ "Name": "Bob", "Age": "25", "City": "Ankara" }
]
La fila de encabezado define las claves. Cada fila de datos se convierte en un objeto. Todos los valores son strings ya que Markdown no tiene información de tipo.
Cómo se Asignan las Tablas Markdown a JSON
Las tablas Markdown tienen una estructura simple y predecible que se asigna directamente a JSON.
| Sintaxis Markdown | Equivalente JSON |
|---|---|
Fila de encabezado | Name | Age | | Claves de objeto |
Fila separadora | --- | --- | | Se ignora |
| Filas de datos | Elementos de arreglo |
| Valor de celda | Valor de propiedad string |
| Celda vacía | String vacío |
El carácter pipe actúa como delimitador de columna. La fila separadora (que contiene guiones y opcionalmente dos puntos para alineación) es puramente sintaxis y no produce datos en la salida.
Cuándo Convertir Markdown a JSON
Procesamiento de README
Los archivos README frecuentemente contienen tablas que listan características, dependencias u opciones de configuración. Convertir estas tablas a JSON te permite validar o comparar documentación entre versiones programáticamente.
Pipelines de Documentación
Si mantienes documentación en Markdown y necesitas alimentar datos estructurados a un sistema de compilación, convertir tablas a JSON te da un formato de entrada limpio para plantillas, índices de búsqueda o generadores de sitios estáticos.
Extracción de Datos de Documentos
La documentación técnica frecuentemente incluye tablas de datos: parámetros de API, códigos de estado, comparaciones de versiones. Convertir estas tablas Markdown a JSON te permite extraer esos datos a fixtures de prueba, esquemas de validación o datos de referencia.
Toma de Notas y Bases de Conocimiento
Markdown es el formato estándar para herramientas de toma de notas. Si rastreas datos estructurados en tablas Markdown (listas de tareas, inventarios, horarios), convertir a JSON te permite construir consultas y vistas sobre esos datos.
Manejo de Casos Extremos
Dos Puntos de Alineación
Las celdas de tabla Markdown pueden tener marcadores de alineación en la fila separadora: :--- para izquierda, ---: para derecha, :---: para centro. El convertidor ignora estos ya que la alineación es una preocupación de presentación, no de datos.
Caracteres Pipe en Valores
Si un valor de celda contiene un carácter pipe, la fuente Markdown debe escaparlo con una barra invertida (\|). El convertidor maneja los pipes escapados correctamente, tratando el pipe literal como contenido en lugar de delimitador.
Conteos de Columnas Inconsistentes
Markdown requiere que cada fila tenga el mismo número de columnas. Si una fila tiene menos celdas, el convertidor llena los valores faltantes con strings vacíos. Si una fila tiene celdas extra, el convertidor típicamente las ignora.
Conversión de Listas Markdown
Más allá de las tablas, las listas Markdown se convierten en arreglos JSON. Las listas anidadas producen arreglos anidados. Una lista de tareas con casillas de verificación produce objetos con estado de verificación:
- [x] Completar diseño
- [ ] Escribir pruebas
- [ ] Desplegar
Se convierte en:
[
{ "text": "Completar diseño", "checked": true },
{ "text": "Escribir pruebas", "checked": false },
{ "text": "Desplegar", "checked": false }
]
Esta conversión es útil para extraer datos de tareas de archivos Markdown a herramientas de gestión de proyectos o pipelines CI/CD.