Como formatar HTML com indentação ou minificação

Cole o HTML como texto, escolha beautify para uma representação indentada ou minify para as transformações compactas documentadas e ajuste a indentação, cujo valor predefinido é de 2 espaços.

Para que serve o formatador de HTML

O HTML Formatter serve para tornar texto HTML mais legível através de uma representação indentada ou para o apresentar num formato mais compacto. É útil quando precisa de rever a estrutura de um fragmento HTML, ajustar a indentação para leitura ou reduzir determinados espaços e comentários antes de analisar o conteúdo. O campo de HTML recebe texto e, por predefinição, está vazio. Uma entrada vazia ou composta apenas por espaços devolve texto formatado vazio com sucesso.

Como formatar ou compactar HTML

1. Introduza o HTML no campo de entrada como texto. Se enviar um valor que não seja uma cadeia de texto, a entrada é rejeitada. Para conteúdo não vazio, confirme também que o tamanho não ultrapassa 1 000 000 bytes em UTF-8.

2. Escolha o modo de saída. O modo predefinido é beautify; se o campo do modo ficar vazio, também recorre a esse modo quando existe conteúdo não vazio. Qualquer valor que, depois de convertido para minúsculas, não seja minify segue o caminho de formatação legível. Para uma saída compacta, selecione minify.

3. Defina a indentação, se necessário. O valor predefinido é de 2 espaços. Para conteúdo não vazio, os valores são convertidos para inteiros quando possível. Se a conversão falhar ou o valor ficar fora do intervalo de 0 a 8, é usado 2. Assim, uma indentação de 0 é aceite, tal como valores entre 1 e 8.

4. Execute a formatação e leia o texto devolvido. No modo beautify, o resultado pode depender da disponibilidade da dependência necessária para interpretar HTML. Se ocorrer uma exceção durante essa interpretação ou durante a formatação, é devolvido um erro de análise HTML em vez de um resultado bem-sucedido.

5. Se escolher minify, tenha em conta o que essa opção altera: remove comentários, excepto comentários cujo conteúdo começa exatamente por [if, elimina espaços em branco entre etiquetas, reduz sequências repetidas de espaços em branco e retira os espaços em branco exteriores.

Como interpretar o resultado

No modo beautify, procure uma representação indentada que facilite a leitura da hierarquia do HTML. A quantidade de espaços no início de cada nível depende da indentação aceite pelo campo: valores inválidos ou fora de 0 a 8 regressam a 2 para conteúdo não vazio. No modo minify, espere apenas as transformações documentadas sobre comentários e espaços em branco; esta opção não deve ser interpretada como compressão completa, validação, limpeza ou filtro de segurança.

Uma entrada vazia ou apenas com espaços tem um tratamento próprio e devolve texto formatado vazio. Por isso, as regras de modo e indentação para conteúdo não vazio não devem ser aplicadas a esse caso. Se o resultado for um erro de análise HTML, reveja a estrutura fornecida e tente novamente; o erro indica que ocorreu uma exceção no processamento de interpretação ou formatação, não uma certificação sobre a validade do documento.

Exemplo prático

Uma pessoa está a rever um fragmento HTML curto e quer separar visualmente os níveis de elementos antes de o ler.

Cole <section><p>Olá</p></section>, selecione beautify, mantenha a indentação predefinida e execute a formatação.

O resultado tem texto HTML formatado: no modo beautify, uma representação indentada; no modo minify, texto com as transformações documentadas de comentários e espaços em branco.

Limitações

• A ferramenta rejeita entradas HTML que não sejam texto e conteúdo não vazio acima de 1 000 000 bytes em UTF-8. A formatação legível pode falhar se a dependência de interpretação HTML não estiver disponível ou se ocorrer uma exceção durante a análise e formatação.

Erros comuns

• Se a ferramenta rejeitar a entrada antes de a formatar, confirme que enviou texto e que o conteúdo não vazio não excede 1 000 000 bytes em UTF-8.

Perguntas frequentes

O que acontece se não escolher um modo?

Para conteúdo não vazio, deixe o modo em branco ou escolha beautify; ambos seguem o caminho de formatação legível quando o modo vazio recorre ao valor predefinido. Uma entrada vazia devolve texto formatado vazio.

Qual é a indentação predefinida?

O valor predefinido é de 2 espaços. Para conteúdo não vazio, valores que não possam ser convertidos para inteiros ou que fiquem fora de 0 a 8 são substituídos por 2.

O modo minify comprime todo o HTML?

O modo minify remove comentários, excepto os que começam exatamente por [if, comprime espaços entre etiquetas, reduz espaços repetidos e retira espaços exteriores. Não corresponde a uma compressão completa do conteúdo.