Formatador de XML
Formate XML com indentação legível preservando elementos, atributos, textos, comentários e entidades escapadas.
Deixe a estrutura XML mais fácil de ler
XML compacto pode ser eficiente para transmitir, mas é difícil de inspecionar. Um elemento, atributo, tag de fechamento ou caractere escapado pode ficar escondido quando tudo está em uma linha. Este formatador mostra um layout legível para revisar a estrutura antes de usar o documento em build, request ou configuração.
A formatação muda a apresentação, não os dados XML pretendidos. Ela deve preservar nomes de elementos, valores de atributos, nós de texto, comentários e referências de entidades enquanto adiciona indentação e quebras de linha consistentes. Um resultado legível facilita a revisão, mas não é validação de schema.
Use uma amostra pequena e representativa ao aprender a ferramenta. Guarde o documento original, a cópia formatada e qualquer resultado de validação posterior separadamente para distinguir sintaxe XML, schema, encoding e regras da aplicação.
Se o documento contiver segredos ou dados pessoais, crie uma cópia redigida antes de colar. Formatar não anonimiza valores nem prova que compartilhá-los com outro serviço seja permitido.
Formatação não é validação
XML é um formato de marcação aninhado com elementos, atributos, texto, comentários, declarações e referências de caracteres. Elementos precisam de tags inicial e final correspondentes, atributos pertencem à tag inicial e caracteres reservados como ampersand devem ser escapados quando representam dados.
O formatador lê estrutura suficiente para organizar nós e espaços. Ele não prova que o documento corresponde a XSD, DTD, política de namespaces, contrato da aplicação ou regra de negócio. Mantenha essas verificações no fluxo que possui essas regras.
Espaços podem ser dados em alguns contextos XML, incluindo conteúdo misto e nós de texto. Antes de alterar um documento usado por um consumidor sensível a espaços, compare a saída com os requisitos dele e preserve a fonte original.
Como formatar XML
- Cole um documento XML completo ou um fragmento documentado no campo de origem. Remova prosa não relacionada ou um wrapper de linguagem da cópia de teste.
- Execute o formatador e examine nesting, atributos, comentários e textos. Uma falha de formatação é motivo para revisar a fonte, não prova de uma mensagem específica do parser.
- Compare o documento formatado com o original. Confirme que nomes, valores, referências de entidades, declarações de namespace e dados de texto não mudaram.
- Depois da formatação, execute o parser XML, validador de schema ou teste da aplicação exigido pelo projeto. Formatar sozinho não demonstra validade ou compatibilidade.
- Para dados de produção, remova segredos e informações pessoais da amostra. Mantenha o arquivo original para um diff controlado e possível rollback.
Método de formatação
- Ler a estrutura XML
A ferramenta lê a marcação como conteúdo XML aninhado e identifica limites de elementos, atributos, textos, comentários e declarações que podem ser organizados.
- Aplicar indentação
O formatador adiciona quebras de linha e indentação para mostrar relações entre pais e filhos. Esse espaço é apresentação, não uma nova regra de schema.
- Preservar valores técnicos
Valores de atributos, referências de entidades, prefixos de namespace e comentários devem continuar ligados à amostra original. Revise um diff quando os bytes exatos forem importantes.
A página pública documenta entrada XML para formatação. Comportamento de recuperação do parser, política de espaços e mensagens de erro exatas exigem teste em um engine real.
Ler o resultado formatado
Um resultado bem-sucedido é uma disposição legível do XML enviado. Confirme que árvore, valores, atributos, comentários e declarações correspondem à fonte.
Uma falha indica que o caminho documentado não conseguiu lidar com a entrada. Não deduza uma regra ou localização exata do parser sem evidência do engine correspondente.
Se o documento falhar depois em XSD ou em uma verificação da aplicação, investigue esse contrato separado. A formatação não adiciona elementos, namespaces ou tipos obrigatórios.
Erros comuns
Confundir indentação com validação de schema pode esconder elementos obrigatórios ausentes ou atributos inválidos.
Trocar entidades escapadas por caracteres visíveis pode alterar dados XML ou invalidar o documento.
Ordenar atributos ou filhos apenas por preferência visual pode mudar a ordem esperada pelo consumidor ou alterar conteúdo misto.
Copiar um fragmento sem a declaração de namespace necessária pode deixar o teste diferente do documento de produção.
Limitações
A capacidade documentada é formatar XML. Isso não comprova validação XSD ou DTD, transformação, canonicalização, análise de segurança ou compatibilidade da aplicação.
Teste com o consumidor alvo o conteúdo misto sensível a espaços, namespaces, documentos grandes e o comportamento específico de recuperação do parser.
Não cole documentos confidenciais de produção salvo se sua política permitir. A cópia formatada pode conter os mesmos valores sensíveis.
Examples
Formatar elemento simples
É possível deixar um elemento compacto legível?
Envie o XML compacto.
Os elementos filhos aparecem em linhas separadas e indentadas sob note.
Manter atributos visíveis
Como revisar um elemento com atributo?
Envie o elemento e examine a tag inicial.
O atributo id permanece em user e o filho name fica indentado.
Preservar texto escapado
Uma entidade dentro do texto permanece intacta?
Formate e compare o nó de texto.
A referência de entidade continua parte da representação textual.
Formatar filhos repetidos
Elementos repetidos podem ficar separados?
Envie o pai com dois filhos item.
Cada filho repetido aparece em sua própria linha, deixando a ordem mais clara.
Manter comentário
O que acontece com um comentário XML?
Formate a amostra de configuração.
O comentário permanece entre o pai e o elemento mode.
Manter declaração
Como uma declaração XML é tratada?
Envie a declaração com o elemento raiz.
A declaração fica no início e o conteúdo de root é indentado abaixo.
Frequently asked questions
Formatação valida um schema XML?
Não. Ela organiza a estrutura XML. Use o XSD, DTD ou validador da aplicação exigido para verificar o schema.
A formatação muda valores dos elementos?
Ela deve preservar valores e estrutura e adicionar espaços de apresentação. Compare com o original quando o texto exato importar.
Comentários são preservados?
Os exemplos tratam comentários como conteúdo que permanece na visualização formatada. Confirme o comportamento para sua entrada antes de usá-lo em pipeline.
Posso formatar um fragmento XML?
Use um documento completo ou uma forma de fragmento documentada. O fragmento pode depender de namespace ou raiz ausente na amostra.
A formatação deixa XML menor?
Não. Normalmente ela adiciona espaços para leitura. Use minificador ou processo de transporte separado quando precisar de saída compacta.
E o ampersand escapado?
Mantenha referências como & como dados XML. Não troque por ampersand sem escape se o contexto deixar de ser XML válido.
A formatação corrige XML malformado?
Não presuma reparo automático. Corrija a fonte deliberadamente e verifique-a com o parser e os testes de schema usados pela aplicação.
O que fazer depois de formatar?
Revise um diff, execute os testes de parser ou schema e teste a cópia com o consumidor real se espaços ou namespaces forem importantes.