Usa el Convertir JSON a Tabla Markdown gratuito abajo: tus datos nunca salen de tu navegador, todo el trabajo ocurre en tu dispositivo y no se sube a ningún servidor.
Convertir JSON en una Tabla Markdown
Las tablas Markdown son la forma más sencilla de mostrar datos estructurados en un documento, un readme, una wiki o un mensaje. Pero escribir una a mano desde JSON es tedioso: copias las claves en una fila de encabezado, añades la fila separadora y después copias cada valor en su lugar, cuidando las barras verticales y los saltos de lÃnea que romperÃan la tabla. Esta herramienta hace todo eso desde un arreglo de objetos, en un solo paso, y el resultado se pega limpiamente en cualquier documento Markdown.
Pega el arreglo, pulsa Convertir y copia la tabla. Las columnas salen de cada clave encontrada en cualquier objeto, en el orden en que aparecen por primera vez. Si un objeto tiene una clave que los demás no tienen, esa clave también se convierte en columna, y los objetos sin ella reciben una celda vacÃa. Ningún dato se pierde porque las formas difieran un poco, que es justo lo que pasa con las respuestas reales de API.
Cómo se Construye la Tabla
La fila de encabezado lista las columnas. La segunda fila es la separadora, hecha de guiones, que indica al procesador Markdown que las filas de arriba y abajo son una tabla. Cada objeto se convierte en una fila, con sus valores en orden de columna. Los valores que faltan se convierten en celdas vacÃas, asà que las filas se mantienen alineadas aunque los objetos tengan claves distintas.
Los valores se muestran con sensatez. Los números y booleanos aparecen tal cual. Los textos aparecen como son, salvo que contengan una barra vertical, que dividirÃa una celda en dos. Las barras se escapan con una barra invertida para que la tabla nunca se rompa. Los saltos de lÃnea dentro de un valor se sustituyen por espacios por la misma razón. Los objetos anidados y los arreglos se muestran como JSON compacto, asà que la información se conserva aunque una celda de tabla no pueda contener estructura propia.
Un solo objeto, en lugar de un arreglo, se convierte en una tabla de dos columnas con clave y valor. Eso sirve cuando quieres documentar un registro, como un usuario o una configuración, de forma legible. Se aplican las mismas reglas de escape, asà que la tabla es segura para pegar donde se muestre Markdown.
Dónde Son Útiles las Tablas Markdown
La documentación es el uso mayor. Un readme que lista productos, ajustes o campos de API se lee mucho mejor como tabla que como bloque de JSON. Los lectores recorren filas y columnas más rápido que llaves y comillas. Una tabla también se muestra en lugares donde el JSON no recibe ningún formato especial, como una página wiki simple o un hilo de mensajes.
Los informes y notas son el segundo uso. Cuando necesitas mostrar unos pocos registros a un compañero, una tabla se lee de inmediato sin ninguna herramienta. Pégala en un documento, un correo que admita Markdown o la descripción de un cambio, y el lector ve los datos al instante. El JSON necesitarÃa un visor o una lectura cuidadosa para dar la misma imagen.
La revisión de datos es el tercer uso. Convertir una muestra de registros a tabla hace visibles los patrones: un valor que falta aparece como celda vacÃa, un valor atÃpico aparece como un número que no encaja en la columna, y un valor incoherente destaca frente a sus vecinos. Revisar diez filas como tabla es más rápido que revisar diez objetos JSON, porque el ojo compara por columnas en lugar de buscar entre anidaciones.
Consejos para Buenas Tablas
Mantén el número de columnas moderado. Una tabla con veinte columnas es difÃcil de leer en cualquier pantalla, y la mayorÃa de los procesadores Markdown no la ajustarán con elegancia. Si tus objetos tienen muchas claves, convierte una copia recortada con solo las claves que tus lectores necesitan, y menciona el registro completo por separado. Diez columnas o menos es una buena regla general.
Vigila el ancho de los valores largos. Un campo de descripción con un párrafo estirará su columna y apretará al resto. Recorta esos campos antes de convertir, o acepta que la tabla sirve como referencia más que para leer de un vistazo. Para tablas de presentación, prefiere registros planos con valores cortos.
Comprueba el resultado en el procesador donde lo usarás. La mayorÃa coinciden en las tablas básicas, pero los detalles de alineación y escape pueden variar un poco. Pega la tabla, previsualÃzala y confirma que las barras dentro de valores quedaron dentro de sus celdas y que cada fila tiene el mismo número de celdas. La herramienta escapa lo que puede, pero una vista previa rápida detecta cualquier cosa inusual en tus datos.
Errores Comunes
El error más común es pasar un objeto que envuelve el arreglo, como una respuesta con un campo data que contiene la lista. La herramienta convierte un solo objeto en una tabla de clave y valor, que no es lo que quieres ahÃ. Extrae primero el arreglo y convierte eso. El segundo error es esperar que los datos anidados se expandan en columnas automáticamente. No lo hacen: se muestran como JSON compacto en una celda, y expandirlos es una decisión tuya.
Privacidad
Todo funciona en tu navegador. Tu JSON nunca sale de tu dispositivo, no se guarda y no se envÃa a ningún servidor. La herramienta es gratuita y no necesita cuenta.