Formateador YAML Gratuito en Línea – Embellece YAML para Kubernetes, Docker y CI

Loading…

Acerca de este Formateador YAML Formateador y Embellecedor YAML en Línea

¿Trabajas con `values.yaml`, `docker-compose.yml` o flujos de trabajo de GitHub Actions desordenados? Este formateador YAML normaliza la indentación y el ajuste de línea preservando anclas, alias y escalares de bloque. Pega tu YAML, ajusta la configuración de indentación y copia una configuración limpia y lista para revisar en segundos. 🚀

Características Principales de Este Formateador de YAML

Formateo basado en Prettier ajustado para archivos de configuración YAML 1.2
Indentación consistente con tamaño de indentación configurable (1–8) y espacios vs tabulaciones
Longitud de línea ajustable para que claves y valores largos sigan siendo legibles
Maneja correctamente anclajes, alias, booleanos-como-cadenas y escalares de bloque multilínea
Funciona con archivos `.yaml` y `.yml` para Kubernetes, Docker Compose, pipelines de CI y más
Pega YAML desde tu editor o arrastra y suelta archivos de configuración en el formateador
Copia con un clic del YAML formateado de vuelta a tu editor o repositorio
El formateo se ejecuta principalmente del lado del cliente en tu navegador; un respaldo seguro del servidor puede usarse solo si falta un analizador/plugin requerido

🔧 Cómo Formatear Archivos de Configuración YAML for yaml-formatter

1. Pega o Sube Tu YAML

Copia cualquier fragmento de YAML (manifiesto de Kubernetes, `docker-compose.yml`, flujo de trabajo de GitHub Actions, playbook de Ansible, etc.) y pégalo en el editor, o arrastra y suelta un archivo `.yaml` / `.yml`.

2. Ajusta la Indentación y el Ajuste de Línea

Elige si usar espacios o tabulaciones, establece el tamaño de indentación (1–8 espacios) y ajusta la longitud de línea para que coincida con el estilo de tu equipo. Una longitud de ajuste de `0` desactiva efectivamente el ajuste al usar un `printWidth` interno muy grande.

3. Ejecuta el Formateador

Haz clic en el botón **Formatear**. El motor de YAML basado en Prettier reescribe tu configuración con indentación consistente mientras preserva anclajes, alias y escalares de bloque para que la semántica no cambie.

4. Copia el YAML Limpio

Revisa la salida, luego copia el YAML formateado de vuelta a tu editor, compromételo en Git o pégalo en tu CI/CD o interfaz de proveedor de nube.

Especificaciones Técnicas

Motor de Formateo y Soporte de YAML

Esta herramienta está construida sobre un formateador de YAML basado en Prettier con opciones de configuración expuestas en la interfaz de usuario.

Característica	Soporte	Notas
Versión de YAML	✅ YAML 1.2 (típico)	Adecuado para YAML de estilo de configuración moderno utilizado en Kubernetes, Docker, CI/CD y aplicaciones.
Anclas y alias	✅ Conservado	Mantiene las referencias `&anchor` y `*alias` intactas mientras reindenta la estructura circundante.
Escalares de bloque	✅ Conservado	Mantiene los escalares de bloque `\|` y `>` respetando la indentación interna.
Booleanos y números	✅ Manejo cuidadoso	El formato conserva los valores pero puede exponer diferencias entre `yes` vs "yes" o `0012` vs "0012".
YAML multi-documento (`---`)	✅ Típico	Múltiples documentos en el mismo archivo se mantienen en orden y formateados consistentemente.

Si un fragmento de YAML dado utiliza sintaxis extremadamente exótica o etiquetas personalizadas que el analizador YAML de Prettier incluido no entiende, puede que veas un error del analizador. En ese caso, simplifica el fragmento o ejecuta el formateo localmente con tu propia cadena de herramientas.

Indentación, Longitud de Línea y Estilo de Salida

El formateador expone opciones clave para que puedas ajustar el estilo de tu proyecto lo más cerca posible.

Configuración	Opciones	Recomendación Práctica
Estilo de indentación	Espacios / Tabulaciones	La mayoría de las guías de estilo YAML recomiendan espacios; tabulaciones solo si tu equipo las prefiere explícitamente.
Tamaño de indentación	1–8 espacios	2 espacios es común para Kubernetes y Docker; 4 espacios para mayor claridad visual.
Ajuste / longitud de línea	0–120 columnas	`0` desactiva el ajuste (usa un `printWidth` interno muy grande), 80–100 mantiene los diffs compactos.
Extensiones de archivo	.yaml, .yml	Coincide con `fileExtensions` y `acceptedFileTypes` en la configuración de la herramienta.

Alinea estas opciones con el `.prettierrc` o `.editorconfig` de tu repositorio para que el formateo en línea coincida con el desarrollo local y las verificaciones de CI.

Límites y Rendimiento

Optimizado para el formateo interactivo de configuraciones YAML en una pestaña del navegador.

Parámetro	Límite / Comportamiento	Notas
Tamaño máximo de entrada de texto	≈ 2 MB (~2,000,000 caracteres)	Límite de seguridad aplicado dentro de la función de formateo.
Tamaño máximo de archivo para subir	≈ 5 MB	Limitado por la configuración `maxFileSize` de la UI para comodidad y confiabilidad.
Tiempo de espera de formato	~25 segundos	Las operaciones de larga duración se abortan para evitar que el navegador se cuelgue.
Ejecución principal	Del lado del cliente	Se ejecuta a través de `runPrettier` y un plugin de Prettier YAML directamente en tu navegador.
Respaldo del servidor	Solo en errores de analizador/plugin	Si falta un plugin de analizador requerido, se puede usar un endpoint seguro `/api/yaml-formatter` como respaldo.

Para paquetes YAML enormes (gráficos de Helm, bibliotecas gigantes de CRD, etc.), prefiere CLI como `prettier` o `yq` integrados en tu flujo de trabajo local o pipelines de CI.

Alternativas CLI para Formateo YAML

Usa el formateador en línea para limpiezas rápidas, y confía en herramientas CLI para proyectos grandes y pipelines automatizados.

Linux / 🍏 macOS

Formatear un archivo YAML con yq (impresión bonita)

yq eval -P config.yaml > config.formatted.yaml

Reescribe YAML con indentación consistente y orden de claves dependiendo de la versión de yq.

Normalizar YAML con Prettier

prettier --parser yaml --write "**/*.{yaml,yml}"

Ejecuta la misma clase de motor (analizador YAML de Prettier) en todo tu repositorio.

Windows (PowerShell / cmd)

Formatear YAML usando PowerShell + yq

yq eval -P config.yaml | Set-Content config.formatted.yaml

Imprime YAML de forma bonita y escribe el resultado de vuelta al disco.

Procesar YAML ida y vuelta a través de objetos de PowerShell

Get-Content config.yaml -Raw | ConvertFrom-Yaml | ConvertTo-Yaml | Set-Content config.formatted.yaml

Usa el soporte YAML de PowerShell para normalizar estructura e indentación.

Combina este formateador en línea con un paso `prettier --check` o `yq` en tu pipeline de CI para garantizar que todo el YAML en el repositorio permanezca formateado consistentemente.

Casos de Uso Prácticos de YAML

Infraestructura y Manifiestos de Kubernetes

Formatear manifiestos de Kubernetes `Deployment`, `Service` e `Ingress` antes de la revisión de código.
Normalizar archivos `values.yaml` en gráficos de Helm para que las diferencias sean más limpias.
Mantener CRDs, ConfigMaps y Secrets YAML consistentemente indentados entre entornos.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
        - name: my-app
          image: my-app:latest
          ports:
            - containerPort: 80

Docker Compose y Configuración de Desarrollo Local

Embellecer `docker-compose.yml` antes de compartirlo en documentación o tickets.
Alinear la indentación de servicios, redes y volúmenes para un mantenimiento más sencillo.
Preparar fragmentos de YAML limpios para publicaciones de blog y guías de incorporación.

version: "3.9"
services:
  web:
    image: myapp:latest
    ports:
      - "8080:80"
    environment:
      - NODE_ENV=production
  db:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: example

Pipelines de CI/CD y Automatización

Formatear flujos de trabajo de GitHub Actions (`.github/workflows/*.yml`).
Limpiar GitLab CI (`.gitlab-ci.yml`) o YAML de Azure Pipelines.
Mantener YAML de automatización e infraestructura como código legible entre equipos.

name: CI
on:
  push:
    branches: [ main ]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm ci
      - run: npm test

❓ Frequently Asked Questions

❓¿Qué hace este formateador de YAML?

Toma una entrada YAML (normalmente archivos de configuración) y la reescribe con indentación y ajuste consistentes usando un motor YAML basado en Prettier. La semántica de tu configuración permanece igual, pero el diseño se vuelve mucho más fácil de leer y revisar.

🧩¿Qué características de YAML son compatibles?

El formateador está diseñado para características comunes de YAML 1.2 utilizadas en archivos de configuración: mapeos, listas, anclas y alias, escalares de bloque (`|` / `>`), y archivos multidocumento separados por `---`. Las etiquetas personalizadas y construcciones muy exóticas pueden no ser totalmente compatibles con el analizador subyacente.

📏¿Hay un límite de tamaño para la entrada YAML?

Para estabilidad y rendimiento del navegador, la entrada de texto está limitada a aproximadamente 2 MB (~2,000,000 caracteres) y los archivos cargados a alrededor de 5 MB. Para bases de código más grandes o YAML generado, ejecuta Prettier o yq desde tu CLI o pipeline de CI en su lugar.

🔐¿Se sube mi YAML a un servidor?

El formateo se ejecuta principalmente en tu navegador a través de `runPrettier` y el plugin YAML de Prettier, por lo que tu YAML no abandona el cliente en operación normal. En raros casos donde falta un plugin de analizador requerido, la herramienta puede recurrir a un endpoint seguro `/api/yaml-formatter`. Incluso entonces, tu YAML solo se procesa de manera transitoria y no se almacena.

⚠️¿Por qué a veces veo errores del analizador?

Los errores del analizador suelen significar que el YAML está mal formado (por ejemplo, indentación inconsistente, falta de `:` o elementos de lista desalineados) o usa sintaxis que el analizador incluido no entiende. Valida la indentación y estructura, o intenta simplificar el fragmento, y luego ejecuta el formateador nuevamente.

📚¿Cómo se relaciona esto con mi configuración local de Prettier?

Esta herramienta utiliza un motor YAML basado en Prettier internamente, similar a ejecutar `prettier --parser yaml`. Puedes usarla para correcciones rápidas puntuales y seguir confiando en tu `.prettierrc` local y comandos CLI para el formateo de proyectos completos.

Pro Tips

Best Practice

Normaliza todo el YAML en un repositorio (Kubernetes, GitHub Actions, Docker Compose) con el mismo estilo de indentación para facilitar mucho las diferencias y revisiones.

Best Practice

Ten cuidado con valores como `yes`, `no`, `on`, `off`, `0012` – enciérralos entre comillas si quieres que se traten como cadenas en lugar de booleanos o números similares a octales.

Best Practice

Usa este formateador en línea para limpiar rápidamente fragmentos para documentación o tickets, luego confía en `prettier` o `yq` en los hooks pre-commit para proyectos completos.

CI Tip

Al refactorizar configuraciones grandes, formatea primero para que los cambios semánticos destaquen claramente en los diffs de Git en lugar de quedar enterrados en ruido de indentación.