Ir al contenido principal
Bethemesh
Desarrollo

Formateador YAML

Reindenta YAML, normaliza su presentación y detecta los principales problemas estructurales directamente en tu navegador.

  • Portapapeles
  • Exportar
Automatizar

Integrar este widget

Personaliza el aspecto, comprueba la vista previa y copia el código.

Vista previa

Tipo de código de integración

Código para copiar

Se adapta a tu página y Bethemesh ajusta su tamaño automáticamente.

¿Te ha resultado útil esta herramienta?

¿Cómo funciona esta herramienta?

Reorganiza la sangría de un documento YAML sin convertirlo a JSON. El formateador analiza la estructura antes de reescribirla y distingue mappings, listas y texto aislado. Conserva la representación documental de comentarios, anclas y valores multilínea en lugar de reconstruir solo los valores resueltos. Resulta útil para configuraciones versionadas o ejemplos que compartirás con un equipo. El archivo permanece en el navegador: el procesamiento no consulta repositorios remotos ni servicios de despliegue.

El parser usa YAML 1.2 por defecto y respeta las directivas de versión compatibles. Tras reconocer el documento, aplica la sangría elegida con un mínimo de dos espacios. Listas y mappings se identifican sintácticamente; reemplazar espacios indiscriminadamente podría alterar el contenido de una cadena literal.

Se rechazan claves repetidas en un mapping, sintaxis no válida y varios documentos en la misma entrada. Las tabulaciones no sirven para la sangría estructural YAML, aunque pueden formar parte de un valor según su escritura. Un escalar como not yaml es válido: YAML no se limita a pares clave-valor.

La presentación trabaja sobre el documento YAML sin expandir alias a objetos JSON. Por eso pueden conservarse anclas y comentarios. Los enteros grandes mantienen su escritura sin pasar por números JavaScript redondeados. Pueden normalizarse espacios de presentación, comillas y espacios en colecciones compactas; la salida no es una copia idéntica byte a byte.

El éxito confirma que este parser puede leer el documento, no que tu aplicación acepte sus parámetros. No carga archivos mencionados en rutas ni interpreta etiquetas personalizadas según reglas de negocio. Otros lectores YAML más antiguos pueden aplicar reglas de tipos diferentes; comprueba la versión que espera tu entorno.

Cómo utilizar esta herramienta

  1. Importa un único documento YAML

    Pega el texto completo con comentarios. Si el archivo contiene varios documentos separados por ---, procesa cada uno individualmente.

  2. Elige la sangría y formatea

    Selecciona una anchura disponible. Si falla, busca mappings sin cerrar, claves duplicadas o una sangría estructural no válida.

  3. Revisa y recupera el archivo

    Compara valores multilínea y comentarios antes de copiar o descargar YAML. Cambiar fuente o sangría oculta el resultado anterior.

Casos de uso

Revisar configuración antes del commit

Uniformiza la sangría para examinar niveles y comentarios. El diseño no confirma nombres de parámetros ni su validez en el programa de destino.

Conservar una configuración documentada

Prefiere el formateador a una conversión de ida y vuelta con JSON cuando comentarios y nombres de anclas ayudan a comprender el archivo.

Separar sintaxis y contrato de datos

Comprueba primero que YAML puede leerse; valida después las reglas de aplicación con las herramientas de tu proyecto.

Ejemplos

Normalizar una sangría válida

Tres espacios son válidos en este caso. La anchura predeterminada de dos espacios realinea child y conserva el comentario note.

Entrada

# note
root:
   child: 1

Resultado

# note
root:
  child: 1

Mantener una lista compacta

El parser reconoce items como lista y active como booleano. La notación compacta sigue representando una lista; solo se normalizan sus espacios de presentación.

Entrada

items: [a, b]
active: true

Resultado

items: [ a, b ]
active: true

Consejos y buenas prácticas

  • No sustituyas globalmente los espacios de YAML: pueden pertenecer a un bloque de texto cuyo valor exacto importa.
  • Entrecomilla las cadenas que parecen fechas o booleanos cuando distintos lectores YAML puedan interpretar el mismo archivo.
  • Usa el convertidor JSON/YAML si necesitas JSON: añade controles sobre los valores que admite el modelo JSON.
  • Conserva directivas y comentarios útiles en la fuente y revisa las diferencias antes de reemplazar una configuración compartida.

Fuentes y referencias

Preguntas frecuentes

¿Por qué se acepta texto simple como YAML?

YAML permite un escalar en la raíz. not yaml es una cadena válida, aunque una aplicación exija un objeto de configuración. La sintaxis del formato y el contrato de aplicación son controles distintos.

¿El formateo elimina comentarios y anclas?

El motor conserva su representación en el documento YAML en lugar de pasar por JSON. La presentación puede variar, pero no los descarta deliberadamente como ocurriría al convertir a un formato sin comentarios.

¿La validación garantiza una configuración Kubernetes correcta?

No. El parser comprueba el documento YAML sin conocer recursos, versiones API o condiciones del clúster. Usa después las validaciones de tu entorno Kubernetes.

¿Por qué se rechazan las claves duplicadas?

Los lectores pueden interpretar de forma distinta un nombre repetido. El rechazo te permite elegir explícitamente el valor o estructura esperados en vez de perder una aparición silenciosamente.

Herramientas relacionadas

Continúa con estas herramientas

Herramientas similares o complementarias a esta.

Herramientas similares

Formateador JSON

Formatea, minimiza y valida un documento JSON para hacerlo más legible o compacto.

DesarrolloDestacadaUsar esta herramienta