Saltar al contenido

Formateador YAML

Vuelva a sangrar y normalice un archivo YAML conservando comentarios, anclas y estructura multidocumento.

Procesado localmente en tu navegador

Opciones
0 caracteres · 0 líneas
El resultado aparecerá aquí.

¿Qué es Formateador YAML?

YAML es el lenguaje de configuración de Kubernetes, Docker Compose, GitHub Actions, OpenAPI y muchísimas otras herramientas. Depende de la sangría: pequeñas incoherencias (anchos de sangría mezclados, espaciado raro en listas en línea) hacen que los archivos sean difíciles de leer y revisar.

Este formateador analiza su YAML con la biblioteca yaml (YAML 1.2, esquema core) y lo vuelve a escribir con 2 o 4 espacios, el ancho de línea que elija y un orden alfabético opcional de las claves. Se conservan comentarios, anclas (&a), alias (*a), claves de fusión (<<) y varios documentos separados por ---. Nada del documento se ejecuta jamás.

¿Cómo funciona?

  1. Pegue su YAML o abra un archivo .yaml / .yml.
  2. Elija 2 o 4 espacios, el ancho de línea (0 desactiva el ajuste) y si ordenar las claves.
  3. Si el YAML no es válido, lea el error: da la línea y la columna.
  4. Copie el resultado formateado o descargue formatted.yaml.

Casos de uso habituales

  • Normalizar manifiestos de Kubernetes o values de Helm antes de un commit.
  • Limpiar un docker-compose.yml o un flujo de CI con sangría irregular.
  • Ordenar las claves de una configuración para que dos archivos se comparen limpiamente.
  • Convertir fragmentos en estilo de flujo ({a: 1, b: [2, 3]}) a estilo de bloque legible con los mismos datos.

Ejemplos

Prueba esta entrada en la herramienta de arriba:

Entrada
# service config
service:
      name:   api
      ports: [80,   443]
      env:
            - {name: MODE,   value: prod}
            - {name: DEBUG, value: "false"}
limits: &limits
   cpu:  "500m"
   memory: 256Mi
worker:
   <<: *limits
   replicas: 3
Salida
# service config
service:
  name: api
  ports: [ 80, 443 ]
  env:
    - { name: MODE, value: prod }
    - { name: DEBUG, value: "false" }
limits: &limits
  cpu: "500m"
  memory: 256Mi
worker:
  <<: *limits
  replicas: 3

Privacidad

Formateador YAML se ejecuta por completo en tu navegador. El texto o los archivos que proporcionas se procesan en tu dispositivo y no se suben, registran ni almacenan en nuestros servidores.

Limitaciones

El formato puede cambiar el estilo de comillas o la grafía de algunos escalares (por ejemplo 0x1F pasa a 0x1f), y un texto largo puede plegarse al ancho elegido. Ordenar claves reordena los mapas y puede afectar a herramientas que dependan del orden.

Preguntas frecuentes

¿Se conservan los comentarios?

Sí. Los comentarios siguen unidos a las entradas a las que pertenecen, incluso al ordenar las claves.

¿Qué versión de YAML se usa?

YAML 1.2 con el esquema core, así que valores como yes, no u on son simples cadenas, no booleanos. Solo true y false son booleanos.

¿Es seguro pegar YAML no confiable?

Sí. Solo se analizan datos, las etiquetas personalizadas nunca se ejecutan y la expansión de alias está limitada para frenar documentos «billion laughs».

Más herramientas en JSON y datos →