Formatar HTML: ajuste a indentação e confira as mudanças
Admin ·
Formatar HTML torna a marcação compacta mais fácil de revisar. O ToolMellow usa o analisador HTML do Prettier para indentar HTML, escolher uma largura preferida e distribuir atributos. Cole o código ou abra um arquivo de texto local; «Formatar HTML» gera um resultado separado.
Confira o resultado antes de usá-lo em uma página ou template. Formatar código HTML pode alterar aspas, disposição de tags e fechamentos. A ferramenta não sanitiza o conteúdo, não comprova toda a validade do documento e não mostra como o navegador vai renderizá-lo.
Formate toda a entrada e compare o resultado
Use «Testar um exemplo» para comparar opções com pouca marcação. Cole seu código em «Entrada» ou escolha «Abrir arquivo de texto». «Formatar HTML» processa a entrada inteira, mesmo com um trecho selecionado.
Quando termina com sucesso, a entrada fica intacta e o código aparece em «Resultado», somente para leitura. Editar a entrada ou mudar uma opção invalida o resultado anterior. Execute «Formatar HTML» novamente para gerar outro atualizado.
- Guarde uma cópia do original antes de editar.
- Escolha indentação de dois ou quatro espaços.
- Ajuste a largura preferida entre 40 e 200.
- Ative «Um atributo por linha» para tags adequadas com vários atributos.
- Execute a formatação e revise alterações e erros.
- Copie ou baixe o resultado completo; reutilize-o se couber no limite de entrada.
Quais opções podem ser ajustadas?
A interface oferece algumas opções do Prettier. A sensibilidade a espaços e a desativação da formatação de linguagens incorporadas são fixas. Não há controle para outro modo de espaços ou para ativar uma etapa JavaScript/CSS nos corpos de script e style.
A marcação ao redor influencia a disposição. Um valor longo pode ultrapassar a largura escolhida, e uma tag com um único atributo pode continuar em uma linha mesmo com a opção de atributos ativa.
| Opção | Valor aqui | Efeito |
|---|---|---|
| Analisador | html | Trata a entrada inteira como código HTML. |
| Indentação | 2 ou 4 espaços | Define a largura de cada nível. |
| Largura de linha preferida | 40–200; padrão 80 | Orienta quebras sem impor um máximo rígido. |
| Um atributo por linha | Opcional | Separa atributos em tags adequadas com vários atributos. |
| Sensibilidade a espaços em branco | strict | Considera os espaços junto às tags ao gerar a saída. |
| Formatação de linguagens incorporadas | off | Pula uma etapa separada de JavaScript ou CSS. |
| Quebrar linhas | Opção visual | Muda a quebra visual do editor sem reescrever o código. |
| Resultado | Somente leitura | Recebe a saída após uma nova formatação bem-sucedida. |
Opções de formatação do PrettierWHATWG HTML: sintaxe e elementos
Escolha dois ou quatro espaços para o aninhamento
Dois espaços mantêm estruturas profundas compactas; quatro destacam mais cada nível. Siga o padrão do projeto para não introduzir uma mudança de estilo desnecessária ao colar um trecho.
A indentação não conserta elementos ausentes nem atributos quebrados. O tratamento estrito de espaços pode manter conteúdo em linha unido ou deslocar um sinal de fechamento de tag para outra linha. Isso não indica falha do controle.
Use a largura como preferência
O controle aceita de 40 a 200 e começa em 80. Valores menores favorecem linhas curtas; maiores deixam mais marcação junta. É um objetivo de apresentação, não um limite que toda linha precisa respeitar.
Um atributo de 250 caracteres, por exemplo, pode superar a largura 40. O formatador não divide esse valor só para cumprir uma contagem de colunas. Confira URLs longas, expressões de template e outros textos indivisíveis.
| Situação | Escolha possível | Efeito esperado |
|---|---|---|
| Janela estreita de revisão | Experimente 40 | Mais quebras onde o gerador de saída puder inseri-las. |
| Edição geral | Comece em 80 | Uma largura intermediária. |
| Editor largo | Experimente 120 | Mais tags e atributos podem permanecer juntos. |
| Visualização muito larga do código | Até 200 | Menos quebras motivadas pela largura, conforme a marcação. |
| Valor longo de atributo | Qualquer largura aceita | O valor pode ultrapassar a preferência. |
| Opção de atributos ativa | Combine com a largura preferida | A disposição dos atributos também influencia a saída. |
Separe atributos quando isso ajudar a revisão
«Um atributo por linha» facilita revisar tags adequadas com vários atributos, como nomes, acessibilidade e atributos de dados longos. É uma preferência de disposição, não uma regra que transforma toda tag de abertura em bloco.
Com um só atributo, <img src="x"> pode continuar em uma linha como <img src="x" />. Construções especiais também têm suas regras. Confira a saída real antes de adotar essa organização no template inteiro.
Entenda quebras incomuns em tags e sinais de fechamento
A sensibilidade a espaços HTML está fixa em strict. Espaços junto a tags em linha podem afetar o texto; por isso <p>Hello <strong>world</strong>!</p> pode continuar junto. Em outros casos, o sinal de fechamento fica abaixo do nome da tag.
O modo estrito não garante espaços idênticos byte a byte nem o mesmo comportamento visual para toda entrada. A disposição ao redor de pre e textarea pode mudar. Revise conteúdo sensível a espaços e teste a página ou template no ambiente de destino.
JavaScript e CSS incorporados ficam sem uma etapa própria
A formatação de linguagens incorporadas está fixa em off. Um script como const x={a:1,b:2}; ou um style como .x{color:red;padding:0} não recebe uma etapa separada de embelezamento JavaScript/CSS. Não há controle para ativá-la.
O gerador HTML ainda pode mover tags, indentação e quebras ao redor desses corpos. Pular a etapa incorporada não garante regiões script ou style idênticas em bytes. Revise também os delimitadores de template antes de substituir o original.
Compare mais do que a indentação
Um formatador analisa e reescreve a marcação, podendo alterar mais do que os espaços iniciais. Os exemplos mostram saídas observadas para entradas específicas, sem prometer aceitar ou reparar qualquer documento malformado.
Compare mudanças com cuidado em código gerado, e-mail HTML e linguagens de template. A formatação não substitui os testes do projeto nem a revisão no navegador e no motor de templates que vão consumir o código.
| Característica da entrada | Mudança observada | O que conferir |
|---|---|---|
| Atributos sem aspas ou com aspas simples | Podem passar a usar aspas duplas. | Aspas e expressões de template. |
Elemento vazio como <input disabled> | A saída pode incluir uma barra de fechamento. | A sintaxe esperada pelo sistema de destino. |
Fechamento ausente em <div>hello | A saída pode incluir </div>. | Análise aceita não equivale a validação completa. |
| Finais de linha CRLF | A saída formatada usa LF. | Mudanças de final de linha no diff. |
| Texto e tags em linha | Podem permanecer na mesma linha. | Não acrescentar espaços que alterem o texto. |
Leia erros sem tratar sucesso como validação
Quando o analisador rejeita o código, o editor mostra um resumo traduzido e o detalhe original do motor, às vezes com linha e coluna. Inspecione também o trecho anterior à posição indicada. Corrija a entrada e formate novamente.
O analisador também pode aceitar fechamentos omitidos ou ausentes e gerar fechamentos inferidos. Sucesso não certifica conformidade HTML, acessibilidade, segurança ou comportamento correto de templates. Não há relatório dedicado de validação nem prévia renderizada.
Separe os limites de entrada, arquivo e histórico
O texto é contado em unidades UTF-16, diferentes de bytes e caracteres visíveis. Uma letra latina simples ocupa uma unidade; 🌿 ocupa duas. Uma sequência emoji exibida pode conter vários pontos de código. Um arquivo precisa caber em bytes e em texto decodificado.
A formatação pode ampliar a saída além do limite de entrada. Copiar e baixar continuam usando tudo. «Usar resultado como entrada» recusa uma saída grande demais e preserva os dois editores.
| Item | Limite | Comportamento na fronteira |
|---|---|---|
| Entrada colada ou processada | 1.000.000 de unidades UTF-16 | O limite exato é aceito; acima dele, o texto é recusado. |
| Arquivo local | Estritamente menos de 4.000.000 de bytes | Exatamente essa quantidade é recusada antes da leitura. |
| Texto decodificado do arquivo | 1.000.000 de unidades UTF-16 | Também deve caber após a decodificação UTF-8. |
| Usar resultado como entrada | 1.000.000 de unidades UTF-16 | Saída maior não é inserida; o resultado segue exportável. |
| Texto de busca | 1.000 unidades UTF-16 | A busca literal na entrada é limitada. |
| Texto de substituição | 10.000 unidades UTF-16 | Uma mudança que exceda a entrada é recusada. |
| Histórico de desfazer e refazer | Até 20 estados anteriores | Registra mudanças aceitas na entrada, não resultados separados. |
| Texto combinado do histórico | 4.000.000 de unidades UTF-16 | Exclui a entrada atual; limita os estados armazenados. |
Abra HTML local como texto UTF-8
«Abrir arquivo de texto» carrega HTML ou texto local. Primeiro verifica bytes, depois lê como UTF-8 e verifica o comprimento decodificado. Não há seletor de codificação; nome e MIME não escolhem outro esquema.
É uma importação de texto. Não busca páginas por URL, não extrai HTML de PDF/Word e não abre scripts, estilos ou imagens vinculados. Se outra codificação causar texto ilegível, converta para UTF-8 em um editor adequado antes de importar.
Copie ou baixe o resultado completo
«Copiar resultado» e «Baixar» usam todo o resultado, não a seleção ou apenas o trecho visível. O download cria texto UTF-8 em toolmellow-result.html. É código formatado, não captura de tela nem pacote das dependências da página.
Mantenha junto do código os recursos e passos de construção necessários. O arquivo não contém folhas de estilo, imagens ou scripts externos. Revise e teste a marcação antes de publicar, sobretudo se veio de fonte não confiável.
Reutilize apenas a saída que cabe na entrada
«Usar resultado como entrada» substitui a entrada por um resultado bem-sucedido que caiba no limite. Gerar o resultado por si só não modifica a entrada. Guarde o original ou use o histórico disponível após a substituição aceita.
Um milhão exato de letras simples mais uma quebra final pode resultar em 1.000.001 unidades de saída. Tudo continua copiável e disponível para baixar, mas a reutilização é recusada. Isso não significa que o resultado foi truncado.
Busca, quebra visual, histórico e Limpar são diferentes
Localizar e substituir usa texto literal da entrada, com diferenciação de maiúsculas opcional. Não interpreta expressões regulares nem nós HTML. $& também é inserido literalmente. Confira correspondências; mudanças aceitas invalidam o resultado anterior.
«Quebrar linhas» muda apenas a apresentação das linhas longas nos dois editores. Não insere quebras no código copiado ou baixado. O HTML permanece da esquerda para a direita mesmo em uma interface da direita para a esquerda.
Desfazer e refazer acompanham edições, importações, substituições e reutilizações aceitas no histórico limitado. Não desfazem a criação de um resultado separado. «Limpar» apaga entrada, resultado, busca e histórico, mantém opções e quebra visual e não pode ser desfeito.
O processamento local também precisa carregar o motor
A formatação roda em um worker do navegador. Os editores são texto: não executam scripts colados nem carregam URLs de imagens coladas. Isso não sanitiza o código para uso posterior. Carregar o worker e o formatador pode exigir rede; processamento local não garante disponibilidade offline.
Se o motor não carregar, mantenha a entrada e tente a ação quando a conexão voltar. «Cancelar» pode parar uma tarefa pendente preservando a entrada. Inicialização e processamento têm limite configurado de 60 segundos; o tempo real depende do navegador e do código. Trabalho cancelado ou desatualizado não é resultado novo.
Perguntas frequentes
A formatação torna seguro um HTML não confiável?
Não. O código é exibido como texto sem execução no editor, mas conteúdo perigoso não é removido. Use sanitização e controles de segurança apropriados onde ele será consumido.
Por que uma linha HTML ultrapassa a largura escolhida?
40–200, com padrão 80, é uma preferência. Valores longos de atributos e textos indivisíveis podem ultrapassá-la.
O formatador conserta HTML inválido?
Pode inferir fechamentos em algumas entradas aceitas; outras geram erros. Não é reparador geral nem validador de conformidade. Confira a saída no ambiente de destino.
Por que tags em linha continuam juntas?
A sensibilidade a espaços é estrita e fixa. O motor pode manter texto unido ou mover um sinal de fechamento. Revise conteúdo sensível a espaços em vez de esperar uma tag em cada linha.
O JavaScript e o CSS incorporados são formatados?
A etapa independente está desativada, sem interruptor para ativá-la. A geração HTML ainda pode mudar a indentação e a disposição ao redor; não há garantia de identidade byte a byte.
Por que um arquivo HTML com menos de 4 MB é recusado?
Além de ter menos de 4.000.000 de bytes, o texto UTF-8 decodificado precisa caber em 1.000.000 de unidades UTF-16, o mesmo limite da entrada. Bytes, unidades e caracteres visíveis são medidas diferentes.
Só o trecho HTML selecionado é formatado?
Não. A entrada inteira é processada. Coloque apenas o trecho desejado em uma entrada separada para formatá-lo sozinho.
Posso desfazer a formatação ou a ação Limpar?
Formatar mantém a entrada e gera um resultado separado. Desfazer/refazer vale para mudanças aceitas na entrada dentro do histórico disponível. «Limpar» remove também o histórico e não pode ser desfeito.
Há uma prévia ao vivo?
Não. Entrada e resultado mostram código-fonte. A ferramenta não renderiza o HTML como página nem busca seus recursos vinculados.
Por que uma tag continua em uma linha com a opção de atributos?
A opção vale para disposições adequadas com vários atributos. Um atributo único pode ficar em uma linha; construções especiais têm regras próprias.
Quebrar linhas muda o HTML baixado?
Não. É uma preferência visual dos editores. O arquivo mantém o resultado completo com suas quebras reais de código.
Posso importar URL, PDF ou Word?
A ferramenta recebe texto de arquivos locais. Não busca HTML em URLs nem extrai conteúdo de PDF ou Word.
Por que não consigo usar o resultado como entrada?
A saída pode superar 1.000.000 de unidades. Copiar e baixar continuam completos, mas reinseri-la ultrapassaria o limite e é recusado sem perder o resultado.
É possível minificar HTML?
Não há ação de minificação HTML. O formato gera código legível conforme as opções; não oferece compressão nem garante saída menor.
Referências primárias
Coloque em prática.
- Formatar HTML
- Minificar CSS
- Formatar JSON
- Limpador de texto e ordenador de linhas
- Conversor de maiúsculas e minúsculas