Convertidor JSON ↔ YAML
Convertidor JSON ↔ YAML
Edita JSON y YAML en paralelo con sincronización bidireccional instantánea. Soporta ajuste de indentación, ordenamiento de claves y división en multi-documento YAML. Útil para configuraciones Kubernetes/Helm/CI y depuración de APIs.
🚀 Inicio rápido
- Pegue o escriba JSON en el editor de la izquierda y YAML en la derecha se actualizará automáticamente.
- También puede escribir YAML a la derecha y JSON a la izquierda se actualiza automáticamente.
- La sincronización es totalmente bidireccional. No es necesario cambiar de modo: edite cualquiera de los lados y el otro lado se actualizará instantáneamente.
- Utilice la barra de herramientas superior para configurar la sangría JSON/YAML, habilitar la clasificación de claves y alternar la salida YAML de varios documentos.
- Presione Tab en el editor para insertar sangría en lugar de mover el foco.
- Cada editor tiene botones Copiar y Borrar en la esquina superior derecha. Limpiar cualquier lado limpia ambos lados.
📌 Escenarios comunes
- Creación de Kubernetes: convierta manifiestos de recursos de K8 entre YAML y JSON para inspeccionar la estructura desde cualquier vista.
- Depuración de valores de Helm: convierta valores.yaml a JSON para inspeccionar tipos y anidamientos en su IDE.
- Canalizaciones de CI/CD: convierta rápidamente fragmentos entre GitHub Actions (YAML) y sistemas de CI que usan JSON.
- Depuración de API: convierta cargas útiles JSON a YAML para obtener una vista jerárquica más clara.
- Migración de configuración: conversión por lotes de archivos de configuración entre YAML y JSON.
- Formato y validación: verifique la sintaxis JSON/YAML mediante sincronización bidireccional, con ubicación de error de línea/columna.
🧭 Consejos de uso
- Una sangría JSON de 2 espacios funciona en la mayoría de los casos; utilice 4 espacios para archivos de valores de Helm o anidamiento profundo.
- Habilite la ordenación de claves para mostrar las claves de objeto en orden alfabético. Así es más fácil comparar diferencias de configuración.
- Cuando la raíz JSON es una matriz, habilite YAML de documentos múltiples para dividir cada elemento en un documento separado (---), útil para archivos K8 de múltiples recursos.
- Si la entrada no es válida, el editor muestra un error con los detalles de la línea/columna; la otra parte conserva su último contenido válido.
- Para contenido grande, pegue primero y espere la sincronización, luego continúe editando para evitar una reconversión excesiva.
⚠️ Limitaciones y compatibilidad
- El análisis de YAML sigue la especificación YAML 1.2. Algunos comportamientos específicos de YAML 1.1 (por ejemplo, conversión booleana automática sí/no) pueden diferir.
- Los números JSON siguen los límites de JavaScript IEEE 754. Los números enteros que superen la precisión segura de 53 bits pueden perder precisión.
- Los anclajes y alias YAML (&, *, <<) se expanden a valores concretos cuando se convierten a JSON; Las referencias no se pueden conservar.
- Los comentarios YAML se eliminan durante la conversión porque JSON no admite comentarios.
🔒 Privacidad y seguridad
- Todo el procesamiento ocurre localmente en su navegador. Tus datos nunca salen de tu dispositivo.
❓ Preguntas frecuentes
¿Cuál es la diferencia entre JSON y YAML y cuándo debo usar cada uno?
JSON y YAML pueden representar los mismos tipos de datos (objetos, matrices, cadenas, números), pero su sintaxis difiere: • JSON utiliza llaves/corchetes y comillas dobles, tiene una sintaxis más estricta y no admite comentarios. • YAML utiliza sangría para la jerarquía, es más legible para los humanos y admite comentarios, pero es sensible a los espacios en blanco. Regla de oro: • Para API e intercambio de datos de máquina a máquina, prefiera JSON. • Para configuraciones de Kubernetes/Helm/CI que los humanos editan con frecuencia, prefiera YAML. • Puede realizar conversiones entre ellos sin cambiar el modelo de datos.
¿Por qué sí/no/activado/desactivado en YAML se vuelve verdadero/falso después de la conversión?
Esto proviene del comportamiento heredado de YAML 1.1, donde sí/no/on/off/y/n puede analizarse como valores booleanos. Esta herramienta sigue YAML 1.2, donde solo verdadero/falso son valores booleanos. Si necesita valores de cadena, cítelos (por ejemplo, "sí").
¿Por qué los comentarios YAML desaparecen después de convertirlos a JSON?
JSON (RFC 8259) no permite comentarios. Por lo tanto, los comentarios YAML no se pueden conservar en la conversión YAML → JSON y no se pueden reconstruir al volver a convertir. Conserve el archivo YAML original si los comentarios son importantes.
¿Qué significa --- en YAML?
--- es el separador de documentos de YAML, que se utiliza para almacenar varios documentos independientes en un solo archivo. Esto es común en Kubernetes, donde un archivo puede contener definiciones de Implementación, Servicio y ConfigMap. Esta herramienta lee YAML de múltiples documentos como una matriz JSON y también puede dividir una matriz JSON nuevamente en documentos YAML separados.
¿Qué debo hacer si se pierde la precisión numérica después de la conversión?
JavaScript utiliza números de doble precisión IEEE 754. Los números enteros seguros varían de -(2^53-1) a 2^53-1 (±9007199254740991). Los números enteros más grandes (por ejemplo, ID de Snowflake o marcas de tiempo de 64 bits) pueden perder precisión. Para conservar los valores exactos, guárdelos como cadenas, como "9007199254740992".
¿Qué sucede con los anclajes YAML (& y *) durante la conversión?
Los anclajes (&nombre) y los alias (*nombre) son funciones de reutilización específicas de YAML. JSON no tiene un mecanismo de referencia equivalente, por lo que los alias se expanden en copias completas durante la conversión. Esta es una transformación con pérdidas y la estructura de anclaje original no se puede restaurar automáticamente.