---
name: heading-outline-repair
description: Use quando uma página se lê bem para uma pessoa mas a sua estrutura de títulos é ilegível para um crawler ou um leitor de ecrã.
---

# Correção da estrutura de títulos

Os títulos formam uma estrutura de documento em que tanto a tecnologia de apoio como os motores de busca se apoiam. Níveis escolhidos pelo tamanho visual em vez da hierarquia produzem uma estrutura que diz algo diferente da página. Esta skill repara a estrutura sem alterar o design.

## O que precisa primeiro

- A página renderizada
- A sua hierarquia visual tal como foi desenhada

## Método

1. Extraia todos os títulos por ordem no documento com o respetivo nível, ignorando por completo o estilo.
2. Verifique as três falhas estruturais: não haver H1, haver mais do que um H1, e níveis saltados como um H2 seguido diretamente de um H4.
3. Leia a estrutura extraída por si só. Se não descrever a página, os níveis estão errados independentemente do aspeto da página.
4. Verifique o que está dentro do H1. Texto oculto destinado a leitores de ecrã, ou um elemento de título rotativo, pode inchar o título para centenas de caracteres - um humano vê um título curto enquanto um crawler lê um parágrafo.
5. Corrija alterando os níveis para corresponderem ao significado, e depois reponha o aspeto com CSS. Tamanho e nível são independentes.
6. Mova qualquer frase destinada apenas a leitores de ecrã para fora do título, para um elemento irmão, para que a tecnologia de apoio a mantenha e o título fique curto.

## O que isto produz

Uma estrutura corrigida, mais qualquer conteúdo oculto removido dos títulos e realojado sem perdas.

## Onde isto corre mal

- Escolher o nível de título pelo tamanho da letra
- Deixar texto visualmente oculto dentro de um H1, o que o incha para os crawlers
- Usar vários H1 porque um template de framework os produz

---

Da biblioteca de competências da QuQi - https://www.quqi.io/pt/skills/heading-outline-repair