¿Cómo escribo cadenas de múltiples líneas en YAML correctamente?

YAML proporciona dos sintaxis de cadenas de múltiples líneas: el escalar de bloque literal (|) que preserva los saltos de línea exactamente, y el escalar de bloque doblado (>) que dobla los saltos de línea en espacios para envolver cadenas largas. Usa | para scripts de shell, consultas SQL y texto de configuración donde los saltos de línea son significativos, y > para descripciones largas en prosa donde quieres envolver líneas en la fuente YAML sin introducir saltos de línea reales. Ambos estilos admiten indicadores de eliminación (+ para mantener los saltos de línea finales, - para eliminarlos).

¿Puedo convertir entre YAML y JSON sin pérdida de datos?

La mayoría de los documentos YAML se convierten a JSON sin pérdida de datos, pero YAML soporta funciones que no tienen equivalente en JSON incluyendo comentarios, anclajes y alias para deduplicación, flujos de múltiples documentos separados por ---, y etiquetas personalizadas. Estas características se eliminan silenciosamente o se convierten a sus representaciones escalares durante la conversión de YAML a JSON. La conversión de JSON a YAML es completamente sin pérdidas ya que todas las construcciones JSON se mapean directamente a la sintaxis YAML.

¿Por qué el validador YAML acepta mi archivo pero mi aplicación lo rechaza?

YAML sintácticamente válido puede seguir fallando en el análisis de la aplicación debido a restricciones de esquema — Kubernetes, por ejemplo, rechaza YAML con claves duplicadas o campos adicionales que no están en el esquema del recurso aunque sean sintácticamente válidos. Las diferencias de coerción de tipos también causan problemas: un booleano YAML 'true' puede pasarse a un campo que tu aplicación espera como la cadena 'true', causando un error de tipo en la capa de la aplicación en lugar de en la capa del analizador. Valida contra el esquema específico de tu aplicación después de confirmar la sintaxis YAML básica.

¿Cuál es la forma correcta de usar tabulaciones versus espacios en YAML?

La especificación YAML prohíbe completamente los caracteres de tabulación para la sangría — debes usar espacios. La mayoría de los editores que no tienen configuración específica para YAML insertarán silenciosamente tabulaciones cuando presiones la tecla Tab, creando archivos que parecen correctos visualmente pero fallan al analizarse. Configura tu editor para insertar espacios (no tabulaciones) para los tipos de archivo YAML y habilita la visibilidad de espacios en blanco para ver la diferencia. Un ancho de sangría consistente de 2 espacios es la convención más común en Kubernetes, GitHub Actions y la mayoría de las herramientas basadas en YAML.

code

GratisSin subida

Formateador YAML

Formatea, valida y convierte datos YAML.

data_objectJSON check_circleValidar keyBase64 fingerprintUUID scheduleTimestamp searchRegex text_formatMayúsculas articleLorem tagHash qr_code_scannerLeer QR table_viewCSV codeXML text_snippetYAML format_list_bulletedMarkdown

YAML de entrada

YAML formateado

Cómo usar

upload_file

Pegue su YAML

Pegue contenido YAML en el área de entrada. El formateador maneja mapeos anidados, secuencias, anclas, alias y cadenas multilínea.

tune

Formatee y valide

Haga clic en Formatear para normalizar la indentación y el espaciado. La validación detecta errores de sintaxis como indentación incorrecta, caracteres inválidos o claves duplicadas.

download

Copie el YAML formateado

Haga clic en Copiar para obtener la salida YAML limpia. Ideal para revisar manifiestos de Kubernetes, configuraciones de CI/CD, archivos Docker Compose o cualquier configuración basada en YAML.

¿Qué es Formateador YAML?

El formateador YAML es una herramienta en línea que valida y formatea archivos YAML para una sintaxis correcta y una sangría consistente, y convierte entre formatos YAML y JSON de forma bidireccional. Resuelve el dolor de depurar archivos de configuración YAML sensibles a la sangría donde un solo espacio mal alineado causa errores de análisis crípticos. Ingenieros de DevOps, desarrolladores backend e ingenieros de plataforma usan el formateo YAML constantemente al trabajar con manifiestos de Kubernetes, flujos de trabajo de GitHub Actions y archivos Docker Compose.

¿Por qué usar Formateador YAML?

Las reglas de espacio en blanco significativo de YAML lo hacen únicamente propenso a errores — el formateador detecta tabulaciones y espacios mezclados, sangría incorrecta de listas y claves de mapeo desalineadas que son invisibles a simple vista en la mayoría de los editores de texto. La conversión bidireccional YAML-a-JSON te permite pegar configuración YAML en herramientas que esperan JSON y viceversa sin reescribir manualmente la estructura. El procesamiento en el navegador asegura que los secretos de Kubernetes y las configuraciones de pipeline CI/CD que contienen credenciales nunca se transmitan a un servidor remoto.

lockPrivacidad completa — Tus archivos nunca salen de tu dispositivo o navegador.
boltProcesamiento instantáneo — Sin tiempos de espera, sin colas de servidor, sin retrasos de carga.
money_off100% gratis — Sin suscripciones, sin créditos, sin tarifas ocultas.
person_offSin registro — Comienza a usar inmediatamente, no se necesita cuenta.
devicesFunciona en todas partes — Cualquier navegador moderno en escritorio, tableta o móvil.

Cómo funciona

Los ingenieros de DevOps pegan el YAML del flujo de trabajo de GitHub Actions en el formateador para diagnosticar errores de sangría que causan que el ejecutor del flujo de trabajo falle con un comportamiento confuso de omisión de pasos en lugar de un error de sintaxis claro. Los ingenieros de plataforma convierten archivos values.yaml de Helm chart a JSON para su uso con validadores de JSON Schema que hacen cumplir los contratos de configuración entre entornos de despliegue. Los desarrolladores backend formatean archivos de especificación OpenAPI escritos en YAML para normalizar la sangría antes de confirmar los cambios en el control de versiones y ejecutar herramientas de prueba de contratos.

tips_and_updates

Consejo Pro

Nunca uses tabulaciones en archivos YAML — la especificación técnicamente las permite en algunas posiciones, pero la mayoría de los analizadores YAML incluyendo los usados por Kubernetes rechazan completamente el contenido con sangría de tabulaciones, así que siempre configura tu editor para insertar espacios en tipos de archivo YAML. Al convertir entre YAML y JSON, ten en cuenta que YAML soporta un sistema de tipos más rico que incluye etiquetas personalizadas y literales de cadenas de múltiples líneas que no tienen un equivalente directo en JSON y serán convertidos a su representación de cadena.

Preguntas frecuentes

La inferencia de tipos de YAML es sorprendentemente agresiva — los valores sin comillas como yes, no, true, false, on, off se interpretan todos como booleanos en YAML 1.1, y valores como 1.0 o 1e3 se analizan como números. Los códigos de país como 'NO' para Noruega o números de puerto como '8080' pueden ser malinterpretados si no están entre comillas. Siempre pon entre comillas los valores de cadena que podrían confundirse con escalares YAML, y usa el formateador para inspeccionar el tipo analizado de los valores ambiguos antes de depender de ellos en el código.

Herramientas relacionadas

data_object

Formateador JSON

Formatea, valida y minifica JSON al instante.

code

Formateador XML

Embellece y valida documentos XML.

table_chart

Formateador CSV

Analiza, valida y formatea datos CSV.