Tres modos de renderizado
Los arrays JSON de objetos se renderizan mejor como tablas Markdown: la herramienta extrae los encabezados de columna de la unión de todas las claves y luego escribe una fila delimitada por pipes por objeto. El orden de columnas sigue el primer objeto por defecto, añadiendo claves adicionales al final. Los valores booleanos y null se renderizan como literales "true", "false" y "null" para que cada celda contenga texto imprimible.
El JSON anidado — objetos dentro de objetos, arrays mixtos — se renderiza como listas de viñetas indentadas. Cada clave se convierte en una viñeta de encabezado y su valor en una viñeta hija. Los arrays de primitivos se convierten en listas inline compactas o viñetas multilínea según la longitud. Este modo es ideal para volcados de configuración, documentación de respuestas de API y entradas de changelog.
El modo bloque de código envuelve el JSON en un bloque delimitado ``` json ``` con sugerencias de resaltado de sintaxis. Usa la forma pretty-print (sangría de 2 espacios) para que la salida sea inmediatamente legible en cualquier renderizador Markdown. Es la forma más rápida de incrustar un ejemplo JSON en un README o página wiki.
Opciones de tabla y casos límite
Al generar tablas, las columnas pueden ordenarse alfabéticamente o en orden de descubrimiento de claves (por defecto). También puedes fijar columnas específicas a la izquierda — útil cuando una clave como "id" o "name" siempre debe ser la primera columna. Las celdas que contienen caracteres pipe se escapan automáticamente con barra invertida para que la tabla no se rompa.
Los objetos anidados dentro de una celda de tabla se serializan como cadena JSON inline compacta. Esto preserva todos los datos a costa de legibilidad para valores profundamente anidados. Alternativamente, activa la opción "aplanar antes de renderizar" para usar claves con notación de puntos como columnas de primer nivel.
Los arrays de tipos mixtos — donde algunos elementos son objetos y otros primitivos — caen graciosamente al renderizador de lista ya que no se puede derivar un conjunto uniforme de columnas. La herramienta siempre elige la salida más legible para la forma de los datos.
Flujos de trabajo de documentación e informes
La documentación de API frecuentemente necesita transformar ejemplos de respuesta JSON en tablas legibles. Pega el JSON de la respuesta, cambia al modo tabla y copia el Markdown directamente en tu plataforma de documentación — Notion, Confluence, GitHub Wiki o un simple README.
Los analistas de datos a menudo reciben informes JSON de APIs o bases de datos y necesitan compartir hallazgos con partes interesadas no técnicas. Convertir a una tabla Markdown hace los datos inmediatamente legibles en cualquier herramienta de chat, correo o generador de sitio estático que soporte Markdown.
Los documentos de incorporación de desarrolladores, referencias de configuración y guías de migración se benefician de tablas Markdown generadas automáticamente en lugar de formateadas manualmente. El convertidor garantiza consistencia y ahorra tiempo cuando los datos subyacentes cambian.