# H1 — título da página
## H2 — seção
### H3 — subseção
#### H4
##### H5
###### H6

A convenção é um único H1 por documento. A sintaxe alternativa "sublinhada" (=== / ---) só cobre H1 e H2 — prefira a forma com #.

**negrito** e *itálico* e ***negrito itálico***

Sublinhados também funcionam (__negrito__, _itálico_), mas só os asteriscos funcionam no meio da palavra: fan**tás**tico.

![texto alternativo que descreve a imagem](https://docs-md.com/favicon.ico)

Uma imagem é um link com ! na frente. O texto alternativo importa: leitores de tela o leem, e ele aparece quando a imagem não carrega.

Documentos longos ficam mais legíveis com [referências nomeadas][docs].

[docs]: https://docs-md.com

As definições podem ficar em qualquer lugar do arquivo — por convenção, no final.

## Primeiros Passos

Vá para [Primeiros Passos](#primeiros-passos) ou [Passo 2: Instalar](#passo-2-instalar).

Regras de slug no GitHub: tudo em minúsculas, pontuação removida exceto hífens e sublinhados, espaços viram hífens, e títulos repetidos ganham -1, -2. "Passo 2: Instalar" vira #passo-2-instalar.

<a id="destino-personalizado"></a>
## Qualquer texto de título

[Ir para lá](#destino-personalizado)

Quando o texto do título pode mudar, fixe um id explícito com uma tag <a> vazia acima dele. Funciona onde HTML na linha é permitido (GitHub, GitLab, a maioria dos geradores de sites estáticos).

```ts
function greet(name: string) {
  return `Hello, ${name}`;
}
```

function greet(name: string) {
  return `Hello, ${name}`;
}

A tag de linguagem depois de ``` ativa o realce de sintaxe. Tags comuns: js, ts, python, bash, json, sql, diff.

| Esquerda | Centro | Direita |
| :--- | :----: | ----: |
| a    |   b    |     c |
| d    |   e    |     f |

Os dois-pontos na linha separadora controlam o alinhamento. Para uma barra vertical literal dentro da célula, escape com \|.

> Um parágrafo citado.
>
> > Citações aninhadas também funcionam.
>
> De volta ao primeiro nível — **a formatação funciona aqui dentro**.

Comece cada linha com > (um > sozinho mantém juntos os parágrafos da mesma citação). O GitHub transforma citações > [!NOTE] / [!WARNING] em alertas coloridos.

> [!NOTE]
> Informação útil que o leitor deve saber.

> [!TIP]
> Uma dica para fazer algo melhor.

> [!IMPORTANT]
> Informação essencial para dar certo.

> [!WARNING]
> Informação urgente que pede atenção imediata.

> [!CAUTION]
> Consequências negativas de uma ação.

Aparecem como caixas coloridas com ícones no GitHub (READMEs, issues, PRs, discussions) e no GitLab. Em outros lugares — prévia do VS Code, Slack, Discord, Notion, a maioria dos geradores de sites estáticos — o texto literal "[!NOTE]" aparece dentro de uma citação simples, que é mais ou menos o que a prévia ao lado mostra.

Acima da linha.

---

Abaixo da linha.

Três ou mais hífens sozinhos na linha, com linhas em branco em volta (senão um --- logo abaixo de um texto vira H2).

Termine a linha com dois espaços  
para quebrar a linha no mesmo parágrafo.

Uma linha em branco começa um novo parágrafo.

Uma barra invertida no fim da linha também força a quebra e é mais fácil de ver do que espaços no final.

O Markdown foi criado em 2004.[^1]

[^1]: Por John Gruber, com contribuições de Aaron Swartz para a sintaxe.

Funciona no GitHub e na maioria dos renderizadores modernos; não faz parte do markdown original.

Pode lançar :tada: :rocket: — ou cole o caractere direto: 🎉 🚀

Códigos como :tada: não são markdown: GitHub, GitLab, Slack e Discord os convertem; renderizadores CommonMark, a prévia do VS Code e a maioria dos geradores de sites estáticos mostram os dois-pontos. Colar o emoji de verdade funciona em qualquer lugar.

```mermaid
graph LR
  A[Escrever markdown] --> B{Compartilhar?}
  B -->|sim| C[Gerar um link]
  B -->|não| D[Manter local]
```

Funciona no GitHub, no GitLab e nas páginas compartilhadas do Docs MD. Também faz diagramas de sequência, gráficos de Gantt e diagramas ER.

O markdown não tem sublinhado, então use <u>HTML</u>, <sub>subscrito</sub>, <sup>sobrescrito</sup> ou <kbd>Ctrl</kbd>+<kbd>C</kbd>.

A maioria dos renderizadores deixa o HTML passar (o GitHub remove scripts e estilos). A prévia desta página remove HTML cru, então confira o resultado na plataforma de destino.

Pressione <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> para abrir a paleta de comandos.

O GitHub mostra <kbd> como uma pequena tecla. Não existe sintaxe nativa do markdown para teclas; crases (`Ctrl`) são a alternativa em texto puro que funciona em qualquer lugar.

<details>
<summary>Clique para expandir</summary>

Conteúdo oculto — **o markdown funciona aqui** se você deixar uma linha em branco depois do summary.

</details>

Funciona no GitHub, no GitLab e na maioria dos sites de documentação. Use <details open> para começar aberto. Não funciona no Slack, no Discord nem no Notion.