Ejemplo verificable
Este JSON contiene un objeto, un número, un booleano, una cadena que parece un número y un array:
{
"servicio": {
"nombre": "api",
"puerto": 8080,
"activo": true,
"version": "1.0",
"etiquetas": ["producción", "privado"]
}
}
El resultado conserva la estructura y los tipos:
servicio:
nombre: api
puerto: 8080
activo: true
version: '1.0'
etiquetas:
- producción
- privado
version permanece entre comillas porque en el JSON original era texto, no un
número.
Cómo funciona
Pega un documento y pulsa Convertir a YAML o utiliza Ctrl/⌘ + Intro. La
herramienta comprueba primero la sintaxis JSON, conserva el orden de las
propiedades y genera YAML en estilo de bloques con dos espacios de sangría.
Las cadenas sencillas se muestran sin comillas. Las que podrían confundirse
con números, booleanos, null o fechas permanecen citadas para conservar su
tipo. Los números se escriben desde su texto original, por lo que un entero
grande no pasa por una conversión de coma flotante.
La guía cómo convertir JSON a YAML sin perder tipos explica qué revisar en cadenas ambiguas, números grandes, colecciones y aplicaciones de destino.
Después puedes copiar el resultado o descargarlo como archivo .yaml. Todo se
ejecuta dentro de esta pestaña, sin peticiones de red, almacenamiento ni datos
añadidos a la URL.
Usos habituales
- Preparar una configuración para Docker Compose o Kubernetes.
- Pasar datos de una API a un archivo más cómodo de revisar.
- Crear la base de un workflow de CI que utilice YAML.
- Convertir ejemplos JSON para documentación técnica.
La conversión cambia la representación, no el significado de los valores. Aun así, conviene validar el resultado con la aplicación que vaya a consumirlo, porque cada herramienta puede aplicar reglas adicionales a su configuración.
Errores frecuentes
- Comas finales: JSON no permite una coma antes de
}o]. - Comillas simples: las propiedades y cadenas JSON utilizan comillas dobles.
- Comentarios: JSON no admite
//ni/* ... */. - Indentación manual posterior: YAML depende de los espacios; al editar el resultado no deben mezclarse tabuladores con la sangría generada.
Si la entrada no es válida, la herramienta muestra el primer problema y su ubicación cuando el navegador puede determinarla. Para un diagnóstico más detallado utiliza el validador JSON.
Casos límite
- Objetos y arrays vacíos se representan como
{}y[]. - Se admiten objetos, arrays, cadenas, números, booleanos y
nullcomo raíz. - Unicode y saltos de línea escapados se conservan.
- Los enteros grandes mantienen todas sus cifras.
- Los nombres de propiedad duplicados se conservan, aunque algunos lectores YAML pueden rechazarlos.
- La entrada se limita a 1.000.000 de caracteres y 100 niveles de anidación para proteger la pestaña.
- JSON no contiene comentarios, anchors ni aliases, por lo que la herramienta no puede inventarlos en el YAML.
Preguntas frecuentes
¿JSON y YAML representan exactamente los mismos tipos?
Ambos pueden representar objetos, listas, texto, números, booleanos y valores nulos. YAML ofrece además construcciones que JSON no tiene. Esta conversión se limita al conjunto de datos presente en JSON y cita los textos ambiguos.
¿Puedo convertir un archivo con comentarios?
No como JSON estricto. Elimina los comentarios o conviértelos en propiedades de texto antes de procesarlo. La herramienta no interpreta JSON5.
¿Se envía mi configuración a un servidor?
No. La validación y la serialización se ejecutan localmente en el navegador. La entrada no se guarda, no se registra y desaparece al cerrar o recargar la página.