Qué hace
Las respuestas de API, las exportaciones y la configuración suelen llegar en JSON, pero una tabla se lee mucho mejor en un README, un pull request, una wiki o un mensaje de chat. Esta herramienta convierte un array JSON de objetos en una tabla de GitHub Flavored Markdown que se ve bien en GitHub, GitLab, Notion, Obsidian y la mayoría de los sitios de documentación.
Cada objeto se convierte en una fila y cada clave en una columna. Los objetos anidados se aplanan en nombres de columna con puntos, las barras verticales y los saltos de línea de los valores se escapan, y las columnas se rellenan para que el Markdown en bruto también quede alineado.
Cómo se usa
- Pega el JSON, sube un archivo
.jsono pulsa Ejemplo. - Elige la Alineación: predeterminada, izquierda, centro, derecha o Números a la derecha para alinear a la derecha las columnas que solo contienen números.
- Deja activado Aplanar objetos anidados para repartir los campos anidados en columnas, o desactívalo para mostrarlos como JSON.
- Desactiva Alinear columnas si prefieres filas compactas sin relleno.
- Copia la tabla o descárgala como archivo
.md.
Si el JSON no es válido, el error muestra la línea y la columna para que lo corrijas rápido.
Ejemplo
Este JSON:
[
{ "name": "ripgrep", "stars": 48000, "repo": { "owner": "BurntSushi" } },
{ "name": "fd", "stars": 34000, "repo": { "owner": "sharkdp" }, "tags": ["find"] }
]
se convierte en esta tabla Markdown:
| name | stars | repo.owner | tags |
| ------- | ----- | ---------- | -------- |
| ripgrep | 48000 | BurntSushi | |
| fd | 34000 | sharkdp | ["find"] |
El objeto anidado repo se convierte en la columna repo.owner, el array tags se escribe como JSON y la primera fila tiene una celda vacía porque no tiene tags.
Consejos
- Los valores se escriben como texto: los números y booleanos aparecen tal cual y
nullqueda como celda vacía. - Las tablas muy anchas se leen mal; elimina los campos que no necesites antes de convertir.
- El Markdown en línea de los valores de texto, como
**negrita**o enlaces, se conserva y la mayoría de los visores lo renderizan. - Para datos CSV, o para generar una tabla HTML, usa las herramientas relacionadas de abajo.
Preguntas frecuentes
› ¿Qué estructuras JSON se admiten?
Un array de objetos genera una fila por objeto, con una columna por cada clave que aparezca en cualquiera de ellos. Un único objeto genera una tabla de dos columnas Key / Value. Un array de arrays genera filas con columnas numeradas, y un array de valores simples genera una sola columna Value.
› ¿Cómo se tratan los objetos anidados?
Con Aplanar objetos anidados activado, los campos anidados se convierten en columnas con puntos, como address.city. Los arrays se escriben como JSON compacto en la celda. Desactiva el aplanado para dejar cada objeto anidado como JSON en una sola celda.
› ¿Y si los objetos tienen claves distintas?
El encabezado es la unión de todas las claves en el orden en que aparecen por primera vez. La celda queda vacía cuando un objeto no tiene esa clave, y los valores null también se muestran como celdas vacías.
› ¿Se sube mi JSON?
No. El análisis y la conversión se hacen por completo en tu navegador, así que las respuestas de API y los datos privados nunca salen de tu dispositivo.