Notas de rodapé

As notas de rodapé são uma extensão do Markdown para adicionar referências ou explicações sem interromper o fluxo da leitura.

Sintaxe básica

Adicionar nota

Uma nota tem duas partes: a marca no texto e o conteúdo ao fim do documento.

Este é um texto com nota[^1].

[^1]: Este é o conteúdo da nota.

Resultado:

Este é um texto com nota[^1].

[^1]: Este é o conteúdo da nota.

Múltiplas notas

Markdown é uma linguagem leve[^1], criada por John Gruber[^2], hoje amplamente usada[^3].

[^1]: Usa sintaxe simples para formatar texto.
[^2]: Criada por John Gruber em 2004.
[^3]: Suportada em GitHub, Stack Overflow e blogs.

Resultado:

Markdown é uma linguagem leve[^2], criada por John Gruber[^3], hoje amplamente usada[^4].

[^2]: Usa sintaxe simples para formatar texto. [^3]: Criada por John Gruber em 2004. [^4]: Suportada em GitHub, Stack Overflow e blogs.

Uso avançado

Identificadores

Podem ser números ou palavras; não podem conter espaços ou tabulações.

Aqui vai uma nota simples[^1] e outra nomeada[^nota].

[^1]: Nota simples.
[^nota]: Nota com identificador.

Resultado:

Aqui vai uma nota simples[^5] e outra nomeada[^nota].

[^5]: Nota simples. [^nota]: Nota com identificador.

Nota com múltiplos parágrafos

O conteúdo pode ter vários parágrafos ou outros elementos (manter indentação).

Esta é uma nota com múltiplos parágrafos[^multi].

[^^multi]: Este é o primeiro parágrafo.

    Este é o segundo parágrafo. Indenta com quatro espaços ou um tab.

    > Também podes ter citações.

    - E listas
    - Ordenadas ou não

Resultado:

Esta é uma nota com múltiplos parágrafos[^multi].

[^^multi]: Este é o primeiro parágrafo.

Este é o segundo parágrafo (com indentação).

> Com citação.

- Com listas
- Ordenadas ou não

Nota inline

Algumas implementações suportam nota inline (não é padrão Markdown):

Isto é uma nota inline^[conteúdo no local, não no fim do doc].

Resultado (onde suportado):

Isto é uma nota inline^[conteúdo no local, não no fim do doc].

Compatibilidade

Suporte por plataforma

Plataforma	Nota padrão	Nota inline	Multi-parágrafo
GitHub Markdown	✅	❌	✅
GitLab Markdown	✅	✅	✅
Jekyll（kramdown）	✅	✅	✅
Hugo	✅	✅	✅
CommonMark	❌	❌	❌
VitePress	✅	✅	✅
Pandoc	✅	✅	✅

Saída HTML

A maioria dos processadores converte notas para HTML com links e retorno:

<!-- referência da nota -->
<p>Texto com nota<sup id="fnref:1"><a href="#fn:1" class="footnote-ref">1</a></sup>.</p>

<!-- conteúdo da nota (no final) -->
<div class="footnotes">
  <hr>
  <ol>
    <li id="fn:1">
      <p>Conteúdo da nota. <a href="#fnref:1" class="footnote-backref">↩</a></p>
    </li>
  </ol>
</div>

Boas práticas

Quando usar

As notas são úteis quando queres:

1. Citar fontes: artigos, livros, referências
2. Acrescentar explicações sem quebrar o fluxo
3. Sugerir leitura adicional
4. Definir termos/abreviações

Recomendações de formatação

✅ Recomenda-se:

1. **Definir no fim** do documento
2. **Consistência** nos identificadores
3. **Moderação** no uso
4. **Conteúdo útil**, não redundante

❌ Evitar:

1. Várias notas no mesmo período
2. Colocar informação essencial numa nota
3. Notas demasiado longas
4. Notas aninhadas

Notas em documentos longos

Em textos longos, agrupa por capítulo:

# Capítulo 1

Conteúdo do capítulo, com uma nota[^1-1].

[^1-1]: Primeira nota do capítulo 1.

# Capítulo 2

Conteúdo do capítulo 2, com outra nota[^2-1].

[^2-1]: Primeira nota do capítulo 2.

Resolução de problemas

Nota não aparece

Se a nota não aparece:

1. Garante correspondência exata entre marca e definição
2. Verifica o espaço após os dois pontos na definição
3. Confirma que o teu processador suporta footnotes
4. Deixa linhas vazias antes/depois da definição

Numeração incoerente

Alguns processadores renumeram automaticamente as notas — comportamento esperado.

Usabilidade em mobile

Os links podem ficar pequenos; leitores com preview flutuante ajudam a usabilidade.

Sintaxe relacionada

• Ligações
• Tachado
• Blocos de código cercados

Exercícios

1. Escreve um texto com 3 notas
2. Cria uma nota multi‑parágrafo
3. Usa notas para referências técnicas/académicas

---

As notas de rodapé aumentam a clareza e a credibilidade do documento, permitindo acrescentar contexto sem quebrar a leitura.