YAML Formatter
NovoValidate, beautify, and convert YAML online. Real-time syntax highlighting, error detection with line numbers, and one-click JSON export.
Input
Formatted output
← paste YAML to see formatted outputRuns entirely in your browser. Nothing is uploaded.
Formate e valide YAML instantaneamente no seu navegador
O formatador YAML valida e embeleza seu YAML em tempo real enquanto você digita ou cola — sem precisar clicar em nenhum botão. Ele normaliza a indentação, destaca erros de sintaxe com números de linha e explicações, e oferece conversão para JSON com um clique. O editor tem destaque de sintaxe completo usando propriedades CSS personalizadas que se adaptam à preferência de modo escuro ou claro do sistema. Tudo roda no lado do cliente usando um parser YAML em JavaScript — seus arquivos de configuração nunca saem do seu dispositivo.
YAML (YAML Ain't Markup Language) é usado em quase todos os projetos de software modernos: fluxos de trabalho do GitHub Actions, manifestos do Kubernetes, arquivos Docker Compose, playbooks do Ansible, charts do Helm, configurações de CI/CD e arquivos de configuração de aplicações. É legível por humanos por design, mas sua sensibilidade à indentação e os caracteres especiais tornam surpreendentemente fácil escrever YAML inválido que só falha em tempo de execução — quando já é tarde demais. Um formatador ao vivo detecta esses erros em segundos.
Erros comuns de YAML e como o validador os detecta
O erro de YAML mais comum é usar tabulações em vez de espaços. YAML proíbe caracteres de tabulação na indentação — eles parecem idênticos a espaços na maioria dos editores de texto, mas causam falhas de análise imediatas. O validador detecta isso e indica exatamente qual linha tem a tabulação. O segundo erro mais comum são os dois pontos sem aspas nos valores: `title: Hello: World` é ambíguo — o parser enxerga uma chave aninhada. Coloque o valor entre aspas: `title: "Hello: World"`. O terceiro é a indentação inconsistente: se um bloco está indentado com 2 espaços em um lugar e com 3 em outro, o parser pode interpretar mal o nível de aninhamento.
Outros erros comuns: chaves duplicadas no mesmo mapeamento (tecnicamente permitido em YAML 1.1 mas ilegal em 1.2, e rejeitado pela maioria dos parsers); falta de espaço após os dois pontos (`chave:valor` é inválido, precisa de `chave: valor`); âncoras e aliases usados incorretamente; e surpresas de coerção implícita de tipos (a string `yes` se torna booleano `true` nos parsers de YAML 1.1). O validador reporta cada um desses com linguagem clara, não apenas um dump de erro do parser.
Conversão de YAML para JSON — quando e por quê
JSON e YAML são formatos de dados semanticamente equivalentes (com algumas exceções). YAML é um superconjunto de JSON — JSON válido também é YAML válido. Converter YAML para JSON é útil ao trabalhar com ferramentas ou APIs que aceitam apenas JSON, ou quando você quer usar `jq` para consultar um arquivo de configuração YAML (jq opera sobre JSON). O botão "Copiar como JSON" faz o parse do seu YAML e serializa para JSON formatado com indentação de 2 espaços.
Uma observação importante: comentários de YAML (linhas que começam com `#`) não são preservados na saída JSON porque JSON não tem sintaxe de comentários. Âncoras e aliases de YAML são resolvidos — o JSON mostra os valores finais desreferenciados. YAML multi-documento (múltiplos documentos separados por `---`) é convertido em um array JSON contendo cada documento como um elemento. Se precisar da operação inversa (JSON para YAML), cole o JSON neste formatador — como JSON é YAML válido, ele vai analisar e reformatar corretamente.
Formatador YAML vs yamllint, YAML Lint e YAML Checker
yamllint é a ferramenta CLI padrão para linting de YAML — completa, configurável e usada em pipelines de CI. Mas requer Python, pip e um terminal, tornando-o inacessível para verificações rápidas na máquina de um colega de equipe ou em um ambiente de navegador. YAML Lint (yamllint.com) é a alternativa online mais popular mas apenas mostra erros — sem formatação, sem destaque de sintaxe, sem conversão para JSON. YAML Checker (yamlchecker.com) formata e valida mas tem uma textarea simples sem destaque e sem saída JSON. Transform.tools faz conversão YAML para JSON mas sem validação ao vivo.
Este formatador combina todas essas capacidades em um único lugar: validação ao vivo com explicações de erros, saída formatada com destaque de sintaxe, conversão para JSON com um clique e suporte a multi-documento — rodando completamente no seu navegador sem backend. É o caminho mais rápido de "esse YAML é válido?" para "aqui está a versão formatada e sem erros" para desenvolvedores que preferem não instalar ferramentas nem fazer cadastro em serviços.
Usos práticos — Kubernetes, GitHub Actions, Docker Compose
Para usuários de Kubernetes: cole seu manifesto antes de aplicá-lo com `kubectl apply` para detectar erros de sintaxe cedo. Um único erro de indentação em uma especificação de Pod ou em uma definição de Service fará o `kubectl` falhar com um erro críptico; detectá-lo aqui primeiro economiza tempo. Para usuários de GitHub Actions: cole seu arquivo `.github/workflows/*.yml` para validar antes de fazer commit. Workflows malformados falham silenciosamente (a action simplesmente não roda) e debugá-los na interface do GitHub é lento. Para usuários de Docker Compose: valide seu `docker-compose.yml` antes de rodar `docker compose up` — especialmente importante para arquivos multi-serviço onde um erro em uma definição de serviço aninhada pode ser difícil de identificar.
Para usuários de Ansible: cole playbooks, arquivos de inventário ou arquivos de variáveis para validar a estrutura YAML antes de rodar `ansible-playbook`. Para autores de charts do Helm: valide seu `values.yaml` ou os templates do chart. Para quem escreve configuração de CI/CD em YAML (GitLab CI, CircleCI, Bitbucket Pipelines, Travis CI): cole a configuração e valide antes de fazer push. Em todos esses casos, o custo de um arquivo YAML inválido é uma build ou deploy com falha — detectá-lo aqui primeiro é sempre mais rápido.
Frequently asked questions
Como formato YAML online?
Cole seu YAML no editor à esquerda e ele é formatado e validado automaticamente em tempo real à direita. O formatador normaliza a indentação para 2 espaços, remove espaços em branco no final e exibe seu YAML com destaque de sintaxe. Se houver erros de sintaxe, eles são destacados em linha com uma explicação do que está errado e em qual linha está o problema. Não há botão para clicar — a formatação acontece enquanto você digita ou cola.
Como valido YAML para detectar erros de sintaxe?
Cole seu YAML e o validador faz o parse imediatamente usando um parser YAML no lado do cliente. Se o YAML for inválido, você verá um banner de erro vermelho com a mensagem de erro específica e o número da linha — o mesmo tipo de erro que um pipeline de CI/CD (como GitHub Actions ou Kubernetes) lançaria. Erros comuns de YAML incluem indentação incorreta (tabulações em vez de espaços — YAML exige espaços), falta de dois pontos após chaves, chaves duplicadas, ou caracteres especiais sem aspas como dois pontos em valores.
Posso converter YAML para JSON?
Sim — há um botão "Copiar como JSON" que faz o parse do seu YAML e gera o JSON equivalente, formatado e pronto para usar. É útil quando você tem um arquivo de configuração YAML (como um workflow do GitHub Actions ou um manifesto do Kubernetes) e precisa dos mesmos dados em formato JSON para uma API, um script ou uma ferramenta que aceita apenas JSON. A conversão é sem perda para YAML padrão — comentários não são preservados em JSON pois JSON não tem sintaxe de comentários.
Por que o YAML precisa de um formatador?
YAML é sensível à indentação: um espaço extra ou um caractere de tabulação onde um espaço era esperado vai quebrar o parse. Isso torna a edição manual de YAML propensa a erros, especialmente em configurações profundamente aninhadas como manifestos do Kubernetes, arquivos Docker Compose, workflows do GitHub Actions e playbooks do Ansible. Um formatador aplica indentação consistente, normaliza espaços em branco e detecta erros de sintaxe antes de chegarem a um pipeline de CI/CD.
Meu YAML fica privado?
Sim — tudo roda no seu navegador. Seu código YAML nunca é enviado para nenhum servidor, nunca é armazenado e nunca é registrado. Isso é especialmente importante para arquivos YAML que podem conter segredos de configuração, chaves de API ou credenciais de banco de dados. Ao contrário de ferramentas YAML baseadas na web que enviam seu conteúdo para um backend para processamento, este formatador analisa e formata completamente no seu navegador usando JavaScript.
Funciona em iPhone e Android?
Sim. O editor é responsivo e funciona no Safari no iPhone e no Chrome no Android. Colar YAML da área de transferência funciona em dispositivos móveis, e a saída formatada e as mensagens de erro são exibidas claramente em telas pequenas. Como tudo é no lado do cliente, a formatação é instantânea sem ida ao servidor.
Preciso me cadastrar ou pagar?
Não. O formatador YAML é completamente gratuito, sem necessidade de conta e sem limites de uso. Você pode formatar, validar e converter o quanto de YAML quiser. Sempre será gratuito.
Related tools
Ver todas as ferramentas
Novo Comparador de diferenças
Compare dois textos e destaque cada diferença, lado a lado ou em linha.
Novo Codificador / Decodificador de URL
Codifique ou decodifique texto com percent-encoding e analise query strings, tudo no navegador.
Novo Codificador / Decodificador de entidades HTML
Escape e reverta entidades HTML, com codificação numérica opcional.
Novo Construtor de expressões Cron
Explique um agendamento Cron em linguagem simples e veja os próximos horários de execução.
Novo Minificador de HTML
Comprima HTML removendo comentários e reduzindo espaços em branco.
Novo Minificador de CSS
Reduza o CSS removendo comentários e espaços em branco desnecessários.