Visualização de JSON e YAML
Visualização de JSON e YAML: guia prático com demo copiável, checklist de revisão e notas de publicação para estrutura JSON ou YAML.

O problema real que isto resolve
Visualização de JSON e YAML é útil quando o diagrama não é apenas uma imagem, mas uma parte mantida da documentação. A fonte precisa continuar legível, a prévia deve revelar erros e a exportação precisa funcionar em README, wiki ou blog.
Use este fluxo para configurações de serviço, payloads de API, YAML de deploy e opções aninhadas. A ideia é criar um ciclo curto de edição, prévia e revisão antes de publicar.

Um demo pequeno para colar primeiro
Não comece com todo o conteúdo de produção. Use primeiro um trecho pequeno para validar sintaxe, rótulos e layout.
Quando a primeira prévia funcionar, adicione nomes reais de serviços, campos, atores ou dependências.
service: checkout
runtime: node
connectsTo:
- postgres
- redis
- payment-api
environments:
staging:
replicas: 2
production:
replicas: 6Como revisar a prévia
Revise como se fosse um colega lendo a página. Ela responde uma pergunta clara? A fonte pode ser alterada depois?
Se o conteúdo veio de IA, confira nomes, direção, agrupamento e relações ausentes.
Erros comuns
O erro mais comum é tentar explicar tudo em um único diagrama. Separe fluxo de requisição, dados, infraestrutura e saída de publicação.
Outro erro é exportar apenas uma imagem. Guarde o texto-fonte junto do SVG ou PNG.
Checklist antes de publicar
Antes de publicar, confira nitidez, rótulos longos e se há um trecho reproduzível no artigo.
A página fica melhor quando mostra entrada, prévia e decisão tomada depois da revisão.