Pontos-chave
- 01Formata YAML com indentação consistente usando o parser js-yaml — a mesma biblioteca usada em ferramentas de build do Node.js.
- 02Valida sintaxe e relata números de linha exatos para erros.
- 03Converte entre YAML e JSON em ambas as direções com preservação correta de tipos.
- 04Nada é enviado — toda a operação é executada localmente no seu navegador.
Por Que a Formatação YAML é Importante para Arquivos de Configuração
YAML é a linguagem de configuração padrão para Kubernetes, GitHub Actions, Docker Compose, gráficos Helm e muitas outras ferramentas. Também é famosamente sensível à indentação — uma única linha mal indentada pode produzir uma incompatibilidade de tipo silenciosa ou um erro de análise difícil que bloqueia uma implantação. A formatação regular mantém os arquivos consistentes e detecta problemas antes que cheguem ao CI.
Converter entre YAML e JSON é igualmente útil. Algumas ferramentas aceitam apenas JSON para chamadas de API ou definições de esquema, enquanto os humanos geralmente preferem YAML para arquivos de configuração de longa duração. Ser capaz de fazer round-trip entre os dois sem perder tipos de dados — números permanecem números, booleanos permanecem booleanos — economiza tempo e evita bugs sutis.
Como Formatar ou Converter YAML
- 01
Cole seu YAML ou JSON
Cole um manifesto Kubernetes, um fluxo de trabalho GitHub Actions, um arquivo de valores Helm ou qualquer outro documento YAML. Para conversão de JSON para YAML, cole JSON em vez disso.
- 02
Escolha uma ação
Selecione Formatar YAML para normalizar indentação e limpar o documento no local. Selecione YAML para JSON ou JSON para YAML para converter o formato completamente.
- 03
Revise erros se houver
Se a entrada tiver um erro de sintaxe, a ferramenta exibe o número de linha exato e o motivo do parser js-yaml — o mesmo parser que suas ferramentas Node.js usam, portanto o erro corresponde ao que você veria em produção.
- 04
Copie a saída
Clique em Copiar para obter a saída formatada ou convertida. Cole-a de volta no seu arquivo de configuração, corpo de API ou definição de esquema.
Quando Esta Ferramenta Economiza Seu Tempo
- 01Manifesto Kubernetes se desviou — normalize indentação antes de fazer commit.
- 02Fluxo de trabalho GitHub Actions falha ao analisar — valide para obter a linha de erro exata.
- 03API aceita apenas JSON mas a configuração é armazenada como YAML — converta com um clique.
- 04Integrando um novo serviço — converta a carga útil de exemplo JSON para YAML para o gráfico Helm.
- 05Copiando YAML do Stack Overflow — reformate para corresponder ao estilo de 2 espaços do seu projeto.
- 06Depurando uma mesclagem de valores Helm — valide que cada values.yaml está individualmente limpo.
Privado, Sem Necessidade de Envio
Formatação e conversão são executadas inteiramente no seu navegador usando js-yaml — a mesma biblioteca agrupada no Webpack, Rollup e na maioria das ferramentas de build JavaScript. Seus arquivos de configuração, referências de segredos e nomes de variáveis de ambiente nunca saem do seu dispositivo.
O parser tem como alvo YAML 1.2, que é o que Kubernetes, GitHub Actions, Docker Compose e Helm usam. Se um arquivo valida aqui, ele será carregado corretamente nessas ferramentas.
Perguntas Frequentes sobre Formatador YAML
A formatação YAML preservará comentários?
Não. O parser js-yaml remove comentários durante a análise — esta é uma limitação de todos os parsers YAML do JavaScript. Formate primeiro e adicione comentários de volta manualmente.
Qual versão YAML isso suporta?
YAML 1.2, que é a versão usada por Kubernetes, GitHub Actions, Docker Compose e Helm. O que valida aqui será carregado corretamente nessas ferramentas.
Converter de YAML para JSON preserva tipos?
Sim. Números, booleanos, null e strings de data fazem round-trip corretamente. Um true em YAML se torna um booleano true em JSON, não a string 'true'.
Qual é a diferença entre formatação e conversão?
Formatação mantém o arquivo como YAML e normaliza espaço em branco e indentação. Conversão muda o formato de saída completamente — YAML para JSON produz um documento compatível com .json.
Meu YAML tem múltiplos documentos separados por ---. Todos serão processados?
O primeiro documento é analisado e re-emitido. Para arquivos com múltiplos documentos, divida cada seção em --- e processe-as individualmente.