Cómo convertir JSON o CSV en una tabla Markdown

Para qué sirve

Markdown Table Generator transforma texto en formato JSON o CSV en una tabla con sintaxis Markdown cuando el procesamiento se completa correctamente. Es útil si necesitas preparar datos tabulares para una documentación técnica, un archivo README o cualquier contenido que admita Markdown. Puedes dejar que la herramienta tome los encabezados de los datos o indicar tus propios nombres de columna. También permite elegir una alineación a la izquierda, centrada o a la derecha.

Cómo convertir los datos

Prepara el contenido como texto. Para JSON, utiliza una estructura que proporcione una fila o varias filas con campos adecuados. Un objeto JSON no vacío se interpreta como una fila. Para CSV, coloca los nombres de columna en la primera línea y los registros en las líneas siguientes.
Pega el contenido en el campo de datos.
Selecciona json o csv como formato. No dejes el formato vacío ni uses otro valor, porque el procesamiento fallará.
Si quieres definir los encabezados manualmente, escríbelos en el campo opcional de encabezados separados por comas, por ejemplo: Producto, Precio, Stock. La herramienta elimina los espacios que rodean cada encabezado.
Elige la alineación: izquierda, centro o derecha. Si no seleccionas una opción, se utiliza la alineación izquierda.
Ejecuta la conversión y revisa el texto Markdown generado. Si trabajas con CSV, comprueba que cada línea use saltos de línea y comas como separadores y que los espacios sobrantes no formen parte de los valores.

Cómo leer el resultado

El resultado esperado es texto de tabla Markdown, con una fila de encabezados, una fila de separación y las filas de datos cuando la entrada proporciona una estructura válida. En JSON, si no indicas encabezados propios, los nombres de las columnas proceden de las claves de la primera fila adecuada. En CSV, la primera línea se usa como encabezado cuando no proporcionas encabezados personalizados.

Un resultado vacío no equivale a una tabla con una fila sin datos. Un valor JSON vacío, como una lista u objeto vacío, null, false, 0 o una cadena vacía, produce una tabla vacía. En cambio, no enviar datos provoca un fallo. El JSON mal formado también devuelve un resultado fallido, y otras estructuras JSON válidas pueden fallar si no ofrecen la forma de fila esperada. En CSV, los campos que superan el número de encabezados se descartan y los que faltan quedan en blanco; revisa por ello la correspondencia entre columnas y registros.

Ejemplo práctico

Una persona necesita documentar el inventario de una taza y quiere mostrar sus tres campos en una tabla Markdown con encabezados definidos manualmente.

Introduce el JSON con esos tres campos, selecciona el formato JSON, escribe «Producto, Precio, Stock» como encabezados y elige la alineación centrada.

El resultado tiene una fila de encabezados con «Producto», «Precio» y «Stock», una fila separadora con marcadores de alineación y una fila de datos con «Taza», «8,50» y «12».

Limitaciones

El tratamiento de CSV separa directamente las líneas por saltos de línea y los campos por comas. Los campos que exceden el número de encabezados se descartan y los campos ausentes quedan en blanco, por lo que conviene revisar datos con comas delimitadoras o filas irregulares.

Errores frecuentes

Error: pegar JSON con una sintaxis incorrecta, una estructura que no representa filas adecuadas o ningún dato. Corrección: valida el JSON, usa una estructura de filas compatible y comprueba que el campo de datos no esté vacío antes de ejecutar la conversión.

Preguntas frecuentes

¿Puedo convertir un objeto JSON en una tabla Markdown?

Sí, si el objeto JSON no está vacío y proporciona una estructura adecuada para una fila. Sus claves pueden convertirse en encabezados cuando no introduces encabezados personalizados.

¿Puedo cambiar los encabezados de la tabla?

Sí. Escribe los nombres separados por comas en el campo opcional de encabezados. Se eliminan los espacios que rodean cada nombre antes de usarlos.

¿Qué opciones de alineación admite?

Elige izquierda, centro o derecha. Si se indica otro valor, los marcadores de la tabla se generan con alineación izquierda.