Referencia técnica y guía de arquitectura

Conversor de YAML a JSON y Sintaxis Bidireccional Cheat Sheet — Guía de referencia

Manual técnico de conversión entre YAML 1.2 y RFC 8259 JSON, resolución de anclajes, bloques multilínea y validación de esquemas de Kubernetes.

Parámetros clave y controles

Modo de Transformaciónstring

Dirección de conversión: YAML a JSON o JSON a YAML.

Por defecto: yaml-to-json
Espaciado de Sangríanumber

Espacios de indentación para el archivo generado (2 o 4 espacios).

Por defecto: 2
Resolución de Anclajesboolean

Expansión automática de anclajes (&) y alias (*) a estructuras JSON completas.

Por defecto: true

Consejos profesionales y mejores prácticas

Anclajes (&) y Alias (*) para Configuraciones DRY

YAML permite reutilizar bloques con &ancla y *alias. La conversión a JSON expande e inserta estas referencias automáticamente en objetos nativos.

Bloques Multilínea: Literal (|) vs Plegado (>)

El operador literal (|) conserva saltos de línea (ideal para scripts y certificados), mientras que el operador plegado (>) los sustituye por espacios.

Privacidad Absoluta y Procesamiento en Navegador

Todas las conversiones se procesan en la memoria local del navegador. Sus secretos de Kubernetes y tokens de despliegue nunca viajan a servidores remotos.

Errores comunes y solución de problemas

Errores de sintaxis causados por tabulaciones ('\t')

El estándar YAML prohíbe taxativamente los tabuladores para indentar. Utilice siempre 2 o 4 espacios en blanco. La herramienta normaliza tabulaciones automáticamente.

Coerción involuntaria de texto a booleano (yes / no)

En YAML valores como yes, no, on, off se evalúan como booleanos. Envuélvalos en comillas simples o dobles para preservarlos como cadenas de texto.

Preguntas frecuentes (FAQ)

¿Cuál es la diferencia fundamental entre YAML 1.2 y JSON?▼

YAML está diseñado para lectura y configuración humana y admite comentarios y anclajes. JSON (RFC 8259) es un estándar estricto de intercambio de datos sin comentarios.

¿Se pueden transformar manifiestos de Kubernetes sin pérdidas?▼

Sí. Todo documento JSON válido es también YAML válido. Las especificaciones y metadatos de Kubernetes se preservan de forma fidedigna en ambas direcciones.

¿Cómo se procesan archivos con múltiples documentos separados por '---'?▼

Los bloques delimitados por '---' se transforman en un array de objetos JSON individuales para su consumo en aplicaciones.

¿Es seguro manipular archivos de configuración privados en este navegador?▼

Completamente seguro. ToolsAA se ejecuta 100% en el lado del cliente ('use client'). Ningún dato de configuración se transmite a servidores.

Herramientas y utilidades relacionadas

Todas las herramientas →