Referência técnica e guia de arquitetura

Conversor de YAML para JSON e Sintaxe Bidirecional Cheat Sheet — Guia de referência

Guia prático para conversão entre YAML 1.2 e RFC 8259 JSON, resolução de âncoras, blocos multilinhas e validação de manifestos Kubernetes.

Parâmetros principais e controles

Modo de Conversãostring

Sentido da transformação: YAML para JSON ou JSON para YAML.

Padrão: yaml-to-json
Espaçamento de Indentaçãonumber

Número de espaços para formatação de saída (2 ou 4 espaços).

Padrão: 2
Resolução de Âncorasboolean

Expansão automática de âncoras (&) e referências (*) em objetos JSON integrados.

Padrão: true

Dicas profissionais e melhores práticas

Uso Eficiente de Âncoras (&) e Aliases (*)

O YAML suporta configurações modulares sem repetição usando &ancora e *alias. Ao converter para JSON, essas referências são expandidas em objetos completos.

Blocos Multilinhas: Literal (|) vs Dobrado (>)

O bloco literal (|) preserva quebras de linha exatas (ideal para scripts e certificados), enquanto o bloco dobrado (>) converte quebras em espaços.

Execução Local Protege Parâmetros de Infraestrutura

Todas as conversões ocorrem na memória do seu navegador. Credenciais e secrets de Kubernetes jamais são enviados para a rede.

Problemas comuns e solução de problemas

Erros de tabulação (mapping values are not allowed)

O padrão YAML proíbe o uso de tabulações para indentação. Utilize sempre espaços. Nossa ferramenta substitui tabulações por espaços automaticamente.

Conversão automática indesejada de yes/no em booleano

Tokens como yes, no, on, off são interpretados como booleanos no YAML. Utilize aspas simples ou duplas para mantê-los como texto puro.

Perguntas frequentes (FAQ)

Qual a diferença essencial entre YAML 1.2 e JSON?▼

O YAML foi criado para facilitar a leitura humana em arquivos de configuração e aceita comentários. O JSON (RFC 8259) é um protocolo de intercâmbio de dados rigoroso.

A conversão de manifestos do Kubernetes é 100% fiel?▼

Sim. Qualquer documento JSON válido é também um YAML válido. Toda a hierarquia de metadados e contêineres é preservada sem perdas.

Como são tratados múltiplos documentos separados por '---'?▼

Documentos múltiplos delimitados por '---' são agregados em uma lista (array) de objetos JSON raiz na conversão.

Posso converter credenciais e arquivos confidenciais sem riscos?▼

Sim. A ferramenta opera 100% no cliente ('use client'). Nenhuma informação de configuração é transmitida a servidores externos.

Ferramentas e utilitários relacionados

Todas as ferramentas →