json.wordkers.com es un banco de trabajo para JSON (el formato de datos de las API y de muchos ficheros de configuración) y para YAML (el de Docker Compose, GitHub Actions, Kubernetes, Ansible y otros ficheros de configuración).

Sirve a quien tiene que:

No hace falta cuenta ni instalar nada.

Validar y formatear un JSON

  1. Pega el JSON en «Entrada».
  2. Mira la barra de abajo. Si dice «✓ JSON válido», a la derecha lo tienes indentado y con colores.
  3. Si dice «✗ JSON no válido», lee el error y la «línea, columna»; haz clic en ella y el cursor va al sitio. Suele ser una coma que sobra o falta, o unas comillas.
  4. Elige la sangría (2 o 4 espacios, o tabulador) y pulsa «Formatear» para que la entrada quede así, o «Minificar» para dejarla en una línea.

Pasar un YAML a JSON

  1. Pega el YAML en «Entrada» (o pulsa «Ejemplo YAML» para ver uno).
  2. Pulsa «YAML → JSON». La entrada se lee como YAML y la salida sale en JSON.
  3. Si la barra de abajo dice «✗ YAML no válido», lee el error (en castellano) y haz clic en «línea, columna» para ir al sitio. Los fallos típicos: sangría que no cuadra, un tabulador en la sangría, falta «:» o un espacio detrás de él, una clave repetida.
  4. Si hay avisos encima de la salida, léelos: son cosas que esta página entiende de una forma y otras herramientas de otra (mira «Entender los avisos de YAML»).
  5. Pulsa «Copiar» o «⬇» (baja datos.json). Si quieres que la entrada pase a ser el JSON, pulsa «Formatear».

Pasar un JSON a YAML

  1. Pega el JSON en «Entrada».
  2. Pulsa «JSON → YAML». La salida sale en YAML.
  3. Elige 2 o 4 espacios de sangría (YAML no admite tabuladores: con «Tabulador» se usan 2 espacios).
  4. Pulsa «Copiar» o «⬇» (baja datos.yaml). Si quieres que la entrada pase a ser el YAML, pulsa «Formatear».

Entender los avisos de YAML

  1. Los avisos salen encima de la salida, cada uno con su línea; no son errores: el texto se ha leído, pero algo puede leerse distinto en otro programa.
  2. «yes», «no», «on», «off», «y», «n» (y en mayúsculas) sin comillas: aquí son texto, como manda YAML 1.2; en YAML 1.1 (PyYAML, Ruby, muchas herramientas antiguas) son verdadero o falso. Si es texto, ponle comillas; si es verdadero o falso, escribe true o false. Pasa también con claves: la clave on: de GitHub Actions.
  3. Números con cero delante (010) o con forma de versión (1.10, 2.0): se leen como números y pierden su forma. Si es un código o una versión, ponle comillas.
  4. Fechas sin comillas (2024-01-01): aquí quedan como texto; otras herramientas las convierten en fecha.
  5. .inf y .nan: JSON no los tiene; en JSON quedan como null.
  6. Tabuladores en la sangría: YAML solo admite espacios. Sangría mezclada (unos niveles entran 2 espacios y otros 4): es válida, pero confunde.
  7. Varios documentos separados por ---: mira «Trabajar con varios documentos YAML».
  8. Anclas &nombre y alias *nombre: en JSON no existen, así que el contenido se copia en cada sitio donde se usa.
  9. Haz clic en un aviso para ir a su línea y corrígelo si hace falta.

Trabajar con varios documentos YAML

  1. Un fichero YAML puede llevar varios documentos separados por líneas ---.
  2. La página los lee todos y lo avisa. En JSON salen como una lista: [documento 1, documento 2, …].
  3. Con la salida en «YAML», se escriben otra vez separados por ---. No se pierde ninguno.

Ordenar las claves o ver el árbol

  1. Pulsa «Ordenar claves»: los campos de cada objeto salen en orden alfabético, en todos los niveles. Sirve para comparar dos ficheros con las mismas claves en distinto orden. Vuelve a pulsarlo para quitarlo.
  2. Pulsa «Árbol» para ver la estructura plegable (un clic en «▸» pliega o despliega). «Texto» vuelve al texto con colores.
  3. Las dos cosas valen igual para JSON y para YAML.

Validar un fichero JSON Lines (.jsonl)

  1. Marca la casilla «JSONL». Cada línea tiene que ser un JSON entero.
  2. Si una línea falla, la barra de abajo dice cuál (línea del fichero y número de registro).
  3. A la derecha ves cada registro formateado con su número de línea. «Minificar» deja cada registro en su línea; «Formatear» se desactiva, porque partiría los registros. Con la salida en «YAML», cada registro sale como un documento YAML.

Abrir, guardar y descargar

  1. «⬆ Abrir» trae un fichero del ordenador (.json, .jsonl, .ndjson, .yaml, .yml o de texto). También puedes arrastrarlo encima del panel «Entrada».
  2. «⬇ Guardar» baja lo que hay en «Entrada», tal cual, con el nombre del fichero abierto (o json.json, json.jsonl o json.yaml si no abriste ninguno).
  3. «⬇» (en la cabecera de «Salida») baja el resultado: datos.json, datos.jsonl o datos.yaml, según el formato de salida. «Copiar» lo copia al portapapeles.

Límites

Privacidad

--- Karb and Sil · CC BY 4.0

Manual completo · el mismo en texto plano