¿Por qué formatear JSON o YAML?
Si trabajas con API REST o pipelines CI/CD, manipulas JSON y YAML varias veces al día. Un JSON compacto copiado desde una respuesta API es difícil de leer; un YAML mal indentado rompe un despliegue Kubernetes. Minificar JSON reduce el tamaño del payload entre un 30 y un 60 % eliminando espacios y saltos de línea.
Tres casos de uso comunes:
- Debug de API → Pretty-Print de un payload JSON minificado para leer los campos e identificar un error
- Conversión de config → Transformar un JSON en YAML para un
docker-compose.ymlo un manifiesto Kubernetes - Validación rápida → Verificar que un documento JSON o YAML no contiene errores de sintaxis
Cómo usar el JSON / YAML Formatter en 3 pasos
Paso 1: Pegar el contenido
Pega tu JSON o YAML en el campo de entrada. La herramienta acepta documentos de hasta 1 Mo.
Paso 2: Elegir la operación
Selecciona el modo adecuado:
- Formatear JSON: Pretty-Print con indentación de 2 espacios (por defecto) o minify
- JSON → YAML: conversión completa a YAML
- Formatear YAML: normaliza la indentación YAML
- YAML → JSON: conversión a JSON indentado
Paso 3: Obtener el resultado
Haz clic en «Formatear / Convertir». El resultado aparece en la zona de resultados. Cópialo directamente.
¿Qué son JSON y YAML?
JSON (RFC 8259) es un formato textual estructurado (objetos, arrays, escalares). Es el estándar dominante de las API REST y el intercambio de datos en la web.
YAML (spec 1.2) es un superconjunto de JSON, más legible gracias a la indentación. Es el estándar para las configuraciones de Kubernetes, Docker Compose, GitHub Actions, GitLab CI y Ansible. Todo JSON válido es también YAML válido.
Ejemplo de conversión:
{
"name": "captaindns.com",
"records": [
{"type": "A", "value": "93.184.216.34"},
{"type": "MX", "value": "mail.captaindns.com"}
]
}
Convertido a YAML:
name: captaindns.com
records:
- type: A
value: 93.184.216.34
- type: MX
value: mail.captaindns.com
¿Qué operaciones soporta la herramienta?
| Operación | Entrada | Salida | Uso típico |
|---|---|---|---|
| Formatear JSON | JSON compacto o mal indentado | JSON indentado (2 o 4 espacios) o minificado | Debug de API, legibilidad |
| JSON → YAML | JSON válido | YAML formateado | Crear un docker-compose, manifiesto K8s |
| Formatear YAML | YAML con indentación irregular | YAML normalizado | Limpiar una config antes de hacer commit |
| YAML → JSON | YAML válido | JSON indentado o minificado | Preparar un payload de API desde una config YAML |
Casos de uso reales
Escenario 1: Depurar una respuesta de API
Síntoma: Recibes un payload JSON minificado de 500 caracteres en una sola línea. Diagnóstico: Pega el JSON y selecciona «Formatear JSON». Acción: El JSON queda indentado y legible. Identifica el campo problemático en segundos.
Escenario 2: Convertir una config de Terraform a YAML
Síntoma: Tienes un output JSON de un terraform output -json y necesitas integrarlo en un archivo YAML.
Diagnóstico: Pega el JSON y selecciona «JSON → YAML».
Acción: Copia el YAML generado directamente en tu archivo de configuración.
Escenario 3: Validar un docker-compose.yml
Síntoma: Un docker compose up falla con un error de parsing.
Diagnóstico: Pega el YAML y selecciona «Formatear YAML». Si el YAML es inválido, la herramienta señala el error.
Acción: Corrige el error identificado y relanza el despliegue.
❓ FAQ - Preguntas frecuentes
P: ¿Cuál es el tamaño máximo aceptado?
R: La herramienta acepta documentos JSON o YAML de hasta 1 Mo. Para archivos más grandes, utiliza jq (JSON) o yq (YAML) en línea de comandos.
P: ¿La herramienta valida la sintaxis JSON?
R: Sí. Si el JSON es inválido, la herramienta devuelve un error explícito (ERR_INVALID_JSON_INPUT) con un mensaje descriptivo.
P: ¿Cuál es la diferencia entre JSON y YAML?
R: JSON utiliza llaves, comillas y comas. YAML utiliza la indentación y es más legible para los humanos. YAML es un superconjunto de JSON.
P: ¿Qué significa minificar JSON?
R: Minificar elimina todos los espacios y saltos de línea innecesarios para obtener un JSON compacto en una sola línea.
P: ¿Cómo gestiona la herramienta las claves no-string en YAML?
R: YAML permite claves numéricas o booleanas (true: value, 42: data). Al convertir a JSON, se convierten automáticamente a cadenas.
P: ¿Se almacenan mis datos?
R: No. El contenido se procesa en memoria y se elimina inmediatamente después de la respuesta.
P: ¿Puedo usar esta herramienta para validar un archivo Kubernetes?
R: La herramienta valida la sintaxis YAML, no el esquema Kubernetes. Utiliza kubectl apply --dry-run para la validación de esquema.
Herramientas complementarias
| Herramienta | Utilidad |
|---|---|
| Codificador / decodificador Base64 | Codificar payloads JSON en Base64 para el transporte |
| Codificador / decodificador URL | Codificar JSON en una query string URL |
| Regex Tester | Extraer valores de un JSON con expresiones regulares |
| Hash Generator | Calcular el hash de un documento JSON para verificar la integridad |
Recursos útiles
- RFC 8259 - The JSON Data Interchange Format (especificación oficial JSON)
- YAML 1.2 Specification (especificación oficial YAML)
- jq - Command-line JSON processor (herramienta CLI para manipular JSON)
- yq - Command-line YAML processor (herramienta CLI para manipular YAML)