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.
Formata e valida YAML instantaneamente no teu browser
O formatador YAML valida e embeleza o teu YAML em tempo real enquanto escreves ou colas — sem necessidade de premir qualquer botão. Normaliza a indentação, realça os erros de sintaxe com números de linha e explicações, e oferece conversão para JSON com um clique. O editor tem realce de sintaxe completo usando propriedades CSS personalizadas que se adaptam à preferência de modo escuro ou claro do sistema. Tudo corre no lado do cliente usando um parser YAML em JavaScript — os teus ficheiros de configuração nunca saem do teu 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, ficheiros Docker Compose, playbooks do Ansible, charts do Helm, configurações de CI/CD e ficheiros de configuração de aplicações. É legível por humanos por design, mas a 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 de mais. Um formatador em tempo real deteta esses erros em segundos.
Erros comuns de YAML e como o validador os deteta
O erro de YAML mais comum é usar tabulações em vez de espaços. YAML proíbe caracteres de tabulação na indentação — parecem idênticos a espaços na maioria dos editores de texto mas causam falhas de análise imediatas. O validador deteta isso e indica-te 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 vê uma chave aninhada. Coloca o valor entre aspas: `title: "Hello: World"`. O terceiro é a indentação inconsistente: se um bloco está indentado com 2 espaços num lugar e com 3 noutro, 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` torna-se booleano `true` nos parsers de YAML 1.1). O validador reporta cada um destes com linguagem clara, não apenas um dump de erro do parser.
Conversão de YAML para JSON — quando e porquê
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 quando se trabalha com ferramentas ou APIs que apenas aceitam JSON, ou quando queres usar `jq` para consultar um ficheiro de configuração YAML (jq opera sobre JSON). O botão "Copiar como JSON" parseia o teu YAML e serializa-o para JSON formatado com indentação de 2 espaços.
Uma nota importante: os 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. As âncoras e aliases de YAML são resolvidos — o JSON mostra os valores finais desreferenciados. YAML multi-documento (múltiplos documentos separados por `---`) é convertido num array JSON contendo cada documento como um elemento. Se precisares da operação inversa (JSON para YAML), cola o JSON neste formatador — dado que JSON é YAML válido, irá analisá-lo e reformatá-lo 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 equipa ou num ambiente de browser. YAML Lint (yamllint.com) é a alternativa online mais popular mas apenas mostra erros — sem formatação, sem realce de sintaxe, sem conversão para JSON. YAML Checker (yamlchecker.com) formata e valida mas tem uma textarea simples sem realce e sem saída JSON. Transform.tools faz conversão YAML para JSON mas sem validação em tempo real.
Este formatador combina todas essas capacidades num único lugar: validação em tempo real com explicações de erros, saída formatada com realce de sintaxe, conversão para JSON com um clique e suporte multi-documento — a correr completamente no teu browser sem backend. É o caminho mais rápido de "será que este YAML é válido?" para "aqui está a versão formatada e sem erros" para os programadores que preferem não instalar ferramentas nem registar-se em serviços.
Usos práticos — Kubernetes, GitHub Actions, Docker Compose
Para utilizadores de Kubernetes: cola o teu manifesto antes de o aplicar com `kubectl apply` para detetar erros de sintaxe cedo. Um único erro de indentação numa especificação de Pod ou numa definição de Service fará o `kubectl` falhar com um erro críptico; detetá-lo aqui primeiro poupa tempo. Para utilizadores de GitHub Actions: cola o teu ficheiro `.github/workflows/*.yml` para validar antes de fazer commit. Fluxos de trabalho malformados falham silenciosamente (a action simplesmente não corre) e depurá-los na interface do GitHub é lento. Para utilizadores de Docker Compose: valida o teu `docker-compose.yml` antes de executar `docker compose up` — especialmente importante para ficheiros multi-serviço onde um erro numa definição de serviço aninhada pode ser difícil de detetar.
Para utilizadores de Ansible: cola playbooks, ficheiros de inventário ou ficheiros de variáveis para validar a estrutura YAML antes de executar `ansible-playbook`. Para autores de charts de Helm: valida o teu `values.yaml` ou os templates do chart. Para qualquer pessoa que escreva configuração de CI/CD em YAML (GitLab CI, CircleCI, Bitbucket Pipelines, Travis CI): cola a configuração e valida antes de fazer push. Em todos estes casos, o custo de um ficheiro YAML inválido é uma build ou deployment falhado — detetá-lo aqui primeiro é sempre mais rápido.
Frequently asked questions
Como formato YAML online?
Cola o teu YAML no editor da esquerda e ele formata e valida automaticamente em tempo real à direita. O formatador normaliza a indentação para 2 espaços, remove espaços em branco no final e mostra o teu YAML com realce de sintaxe. Se houver erros de sintaxe, são realçados em linha com uma explicação do que está errado e em que linha está o problema. Não há botão para premir — a formatação acontece enquanto escreves ou colas.
Como valido YAML para detetar erros de sintaxe?
Cola o teu YAML e o validador analisa-o imediatamente usando um parser YAML do lado do cliente. Se o YAML for inválido, verás um banner de erro vermelho com a mensagem de erro específica e o número de 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 requer espaços), falta de dois pontos após chaves, chaves duplicadas, ou caracteres especiais sem aspas como dois pontos nos valores.
Posso converter YAML para JSON?
Sim — há um botão "Copiar como JSON" que parseia o teu YAML e produz o JSON equivalente, formatado e pronto a usar. É útil quando tens um ficheiro de configuração YAML (como um fluxo de trabalho do GitHub Actions ou um manifesto do Kubernetes) e precisas dos mesmos dados em formato JSON para uma API, um script ou uma ferramenta que apenas aceita JSON. A conversão não tem perdas para YAML padrão — os comentários não são preservados em JSON pois JSON não tem sintaxe de comentários.
Porque é que o YAML precisa de um formatador?
YAML é sensível à indentação: um espaço extra ou um carácter de tabulação onde era esperado um espaço irá quebrar a análise. Isto torna a edição manual de YAML propensa a erros, especialmente em configurações profundamente aninhadas como manifestos do Kubernetes, ficheiros Docker Compose, fluxos de trabalho do GitHub Actions e playbooks do Ansible. Um formatador aplica indentação consistente, normaliza espaços em branco e deteta erros de sintaxe antes de chegarem a um pipeline de CI/CD.
O meu YAML fica privado?
Sim — tudo corre no teu browser. O teu código YAML nunca é enviado para nenhum servidor, nunca é armazenado e nunca é registado. Isto é especialmente importante para ficheiros YAML que podem conter segredos de configuração, chaves de API ou credenciais de base de dados. Ao contrário das ferramentas YAML baseadas na web que enviam o teu conteúdo para um backend para processamento, este formatador analisa e formata completamente no teu browser usando JavaScript.
Funciona em iPhone e Android?
Sim. O editor é responsivo e funciona no Safari em iPhone e no Chrome em 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 ecrãs pequenos. Como tudo é do lado do cliente, a formatação é instantânea sem viagem ao servidor.
Preciso de me registar ou pagar?
Não. O formatador YAML é completamente gratuito, sem necessidade de conta e sem limites de utilização. Podes formatar, validar e converter todo o YAML que quiseres. Será sempre 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 / Descodificador de URL
Codifique ou descodifique texto em percentagem e analise query strings, tudo no seu navegador.
Novo Codificador / Descodificador de entidades HTML
Escape e remova o escape de entidades HTML, com codificação numérica opcional.
Novo Construtor de expressões Cron
Explique um agendamento Cron em linguagem comum e pré-visualize as próximas execuções.
Novo Minificador de HTML
Comprima HTML removendo comentários e reduzindo os espaços em branco.
Novo Minificador de CSS
Reduza o CSS removendo comentários e espaços em branco desnecessários.