---
title: Cabeçalhos
description: Estruture páginas com cabeçalhos H2 e H3 que preenchem automaticamente o índice à direita e geram links de âncora compartilháveis.
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Os cabeçalhos Markdown (`##`, `###`) dividem sua página em seções que os leitores podem analisar rapidamente. O Jamdesk identifica cabeçalhos H2 e H3 para o índice do lado direito e gera links de âncora que você pode compartilhar diretamente.

## Uso básico

Use cabeçalhos Markdown padrão para estruturar seu conteúdo:

```markdown
## Section Title

Content goes here...

### Subsection

More detailed content...
```

Os cabeçalhos H2 e H3 aparecem no **Table of Contents** do lado direito para que os leitores possam navegar entre as seções de páginas longas.

## Links de âncora

Cada cabeçalho gera automaticamente um ID de âncora a partir de seu texto:

| Cabeçalho                    | Âncora gerada       |
| ------------------------- | ---------------------- |
| `## Getting Started`      | `#getting-started`     |
| `## API Reference`        | `#api-reference`       |
| `### User Authentication` | `#user-authentication` |

### Compartilhar links de cabeçalho

Passe o cursor sobre qualquer cabeçalho H2 ou H3 para exibir um **ícone de link**. Isso facilita o compartilhamento de links diretos para seções específicas:

- **Clique no ícone de link** para copiar a URL para a área de transferência
- **Clique no texto do cabeçalho** para copiar a URL e navegar até essa seção

O ícone de link aparece em uma pequena caixa com borda à esquerda do cabeçalho. Ao copiar um link, o ícone muda brevemente de cor para confirmar a ação.

<Note>
  Em dispositivos móveis, o ícone de link fica oculto porque não há estado de passagem do cursor.
  Os cabeçalhos continuam funcionando normalmente para navegação.
</Note>

### Criar links para cabeçalhos

Faça referência a seções específicas de outras páginas usando a âncora:

```markdown
See the [headings section](/content/mdx-basics#headings) for details.
```

## Práticas recomendadas

<AccordionGroup>
  <Accordion title="Use uma hierarquia clara" icon="sitemap" defaultOpen>
    Comece com H2 para seções principais e H3 para subseções:

    ```markdown
    ## Installation

    ### Prerequisites

    ### Quick Install

    ## Configuration

    ### Basic Options

    ### Advanced Options
    ```

    Evite pular níveis (por exemplo, passar de H2 para H4).

  </Accordion>

  <Accordion title="Mantenha os cabeçalhos concisos" icon="text-width">
    Cabeçalhos curtos são mais fáceis de analisar:

    ```markdown
    {/* Good */}
    ## Authentication

    {/* Avoid */}
    ## How to Set Up Authentication in Your Application
    ```

  </Accordion>

  <Accordion title="Use maiúsculas apenas no início" icon="font">
    Coloque em maiúscula apenas a primeira palavra e os nomes próprios:

    ```markdown
    {/* Good */}
    ## Getting started with the API

    {/* Avoid */}
    ## Getting Started With The API
    ```

  </Accordion>
</AccordionGroup>

## O que vem a seguir?

<Columns cols={2}>
  <Card title="Otimização de SEO" icon="magnifying-glass-chart" href="/pt/content/seo">
    Melhore a descoberta e os metadados
  </Card>
  <Card title="Frontmatter" icon="file-lines" href="/pt/content/frontmatter">
    Defina títulos, descrições e campos de SEO
  </Card>
</Columns>