Exemplos práticos de redação técnica com alta acessibilidade (a11y), navegação inclusiva por leitores de tela e hierarquia estrita.

🗺️ Mapa de Experiência de Usuários com Tecnologias Assistivas

flowchart LR
    DOC["Markdown Semântico"]
    --> SCREEN_READER["Leitor de Tela (NVDA / VoiceOver)"]
    SCREEN_READER --> LIST_H["1. Tecla 'H': Pula de Cabeçalho em Cabeçalho"]
    SCREEN_READER --> LIST_L["2. Tecla 'K': Lista Todos os Links Fora de Contexto"]
    SCREEN_READER --> IMG_READ["3. Lê Alt Text Completo das Imagens e Gráficos ⚡"]

    style DOC fill:#ede7f6,stroke:#512da8,stroke-width:2px
    style SCREEN_READER fill:#fff3e0,stroke:#ff9800,stroke-width:2px
    style LIST_H fill:#e1f5fe,stroke:#03a9f4,stroke-width:1.5px
    style LIST_L fill:#e8f5e9,stroke:#4caf50,stroke-width:1.5px
    style IMG_READ fill:#00897b,stroke:#004d40,stroke-width:2px,color:#ffffff

📄 Exemplo 1: Comparação Prática de Acessibilidade em Documentação

❌ Exemplo Antipattern (Inacessível):

# Instalação

#### Baixar o binário
Para fazer o download, [clique aqui](https://exemplo.org/dl).

![foto](assets/img.png)

Problemas: Pulou de H1 para H4; link “clique aqui” sem contexto se lido em uma lista isolada; imagem sem descrição textual compreensível.

✅ Exemplo Padrão Ouro (100% Acessível):

# Guia de Instalação e Configuração da CLI

## Download e Verificação de Assinatura

Obtenha o pacote binário acessando o [portal de downloads oficiais da ferramenta para Linux e Windows](https://exemplo.org/dl).

![Terminal do Ubuntu exibindo o comando de verificação sha256sum com status OK destacado em verde](assets/checksum_validado.png)

📄 Exemplo 2: Tabelas Acessíveis com Cabeçalhos Explícitos

| Código de Erro | Significado Técnico | Ação Recomendada para o Operador |
| :--- | :--- | :--- |
| `ERR_AUTH_01` | Credenciais expiradas | Renovar o token via comando `auth refresh` |
| `ERR_NET_04` | Timeout na conexão com o banco | Verificar regras de firewall na porta 5432 |