JSON a tabla Markdown
Pega un array JSON de objetos y obtén una tabla limpia en GitHub Flavored Markdown para README, documentación, issues y wikis. Elige y reordena columnas, aplana objetos anidados, ajusta la alineación y revisa la vista previa renderizada.
Última actualización:
Se convierte localmente en tu navegador; tu JSON nunca se sube. El resultado sigue la sintaxis de tablas de GitHub Flavored Markdown.
Cómo usar JSON a tabla Markdown
- Pega tu JSON, normalmente un array de objetos como una respuesta de API, o abre un archivo .json. Se carga un ejemplo para empezar.
- Elige las columnas: desmarca las que no necesitas y usa las flechas para cambiar su orden.
- Elige cómo se muestran los datos anidados: columnas aplanadas con punto, JSON compacto o JSON como código.
- Ajusta la alineación y el estilo: alineación de columnas, alineación de números, texto para null, encabezados en Mayúscula Inicial, números de fila y relleno.
- Revisa la pestaña Vista previa y luego copia el Markdown o descárgalo como archivo .md y pégalo en tu README o issue.
Ejemplo: de array JSON a tabla Markdown
[
{"name": "Ada", "role": "Engineer", "salary": 120000, "address": {"city": "London"}},
{"name": "Alan", "role": "Researcher", "salary": 98500.5, "address": {"city": "Manchester"}}
]se convierte en esta tabla, con el objeto anidado address aplanado en su propia columna y la columna numérica alineada a la derecha:
| name | role | salary | address.city |
| ---- | ---------- | ------: | ------------ |
| Ada | Engineer | 120000 | London |
| Alan | Researcher | 98500.5 | Manchester |Guía rápida de la sintaxis de tablas Markdown
| Parte | Sintaxis | Notas |
|---|---|---|
| Fila de encabezado | | Name | Age | | Obligatoria. Cada tabla necesita exactamente una fila de encabezado. |
| Fila separadora | | --- | --- | | Al menos tres guiones por columna en muchos renderizadores; los dos puntos fijan la alineación. |
| Alinear a la izquierda | :--- | Igual que la predeterminada en la mayoría de los sitios. |
| Centrar | :---: | Útil para valores de estado cortos como ✓ o Sí/No. |
| Alinear a la derecha | ---: | Ideal para números, para que las cifras queden alineadas. |
| Barra vertical dentro de una celda | \| | Una | sin escapar empieza una celda nueva. |
| Salto de línea en una celda | <br> | Las celdas no pueden ocupar varias líneas del código fuente. |
| Celda vacía | | | | Deja vacío el espacio entre las barras. |
Consejos para tablas legibles
- Oculta lo que los lectores no necesitan. Las respuestas de API suelen incluir ID, marcas de tiempo y URL; desmarca esas columnas para que la tabla sea lo bastante estrecha para un README.
- El relleno es opcional. Los renderizadores ignoran los espacios extra, pero el código con relleno es mucho más fácil de leer y revisar en el diff de un pull request. Desactiva el relleno para obtener el resultado más pequeño.
- Los valores muy largos hacen que las tablas se desplacen de lado en GitHub. Plantéate aplanar solo los campos que necesitas o acortar el texto antes de convertir.
- ¿Necesitas otra cosa? Para una tabla que escribes a mano, usa el Generador de tablas Markdown; para obtener HTML, usa JSON a tabla HTML.
Preguntas frecuentes
¿Qué estructuras JSON se pueden convertir?
Un array de objetos es lo que mejor funciona: cada objeto se convierte en una fila y cada clave en una columna. La herramienta también acepta un objeto cuyos valores son objetos (cada uno se convierte en una fila con una columna de clave), un array de arrays (la primera fila se convierte en el encabezado si solo contiene cadenas), un array de valores simples (una columna de valores) y un objeto único (una fila).
¿Qué pasa cuando los objetos tienen claves distintas?
Las columnas son la unión de todas las claves en el orden en que aparecen por primera vez. Una fila que no tiene una clave recibe una celda vacía, o el texto que elijas para valores null y ausentes, como null, un guion o N/A.
¿Cómo se muestran los objetos y arrays anidados?
De forma predeterminada, los objetos anidados se aplanan en columnas con notación de punto, así que address.city se convierte en su propia columna, y los arrays de valores simples se unen con comas. También puedes conservar los valores anidados como JSON compacto, opcionalmente entre comillas invertidas para que Markdown los muestre como código.
¿Cómo alineo las columnas en una tabla Markdown?
La alineación se fija en la fila separadora bajo el encabezado: :--- alinea a la izquierda, :---: centra y ---: alinea a la derecha. Un --- simple usa la alineación predeterminada del renderizador, que en GitHub es a la izquierda. Con 'Alinear a la derecha las columnas numéricas' activado, las columnas que solo contienen números se alinean a la derecha automáticamente para que las cifras queden alineadas.
¿Qué pasa si un valor contiene una barra vertical o un salto de línea?
Una | sin escapar cerraría la celda antes de tiempo, así que la herramienta la escapa como \|. Las celdas de una tabla Markdown deben ocupar una sola línea, así que los saltos de línea dentro de los valores se reemplazan por <br>, que GitHub, GitLab y la mayoría de los renderizadores muestran como salto de línea.
¿Dónde puedo usar la tabla generada?
El resultado sigue la sintaxis de tablas de GitHub Flavored Markdown, compatible con README, issues y wikis de GitHub y GitLab, Bitbucket, Obsidian, Docusaurus, MkDocs y la mayoría de los generadores de sitios estáticos.
¿Se sube mi JSON?
No. La conversión se hace por completo con JavaScript en esta página, así que tus datos nunca salen de tu dispositivo.
¿Se prueban todas las herramientas de FreeToolCabin para comprobar su calidad y precisión?
Sí. Cada herramienta del sitio pasa pruebas automáticas en navegadores reales para comprobar que el resultado es correcto y que no hay errores. Si encuentras un fallo o tienes una sugerencia, escríbenos a [email protected] y lo revisaremos.
Herramientas relacionadas
Ver todas las de Conversores de datos y formatos de archivo →