Sintaxe de citações

As citações (blockquote) destacam texto citado ou notas importantes. Em Markdown, usa‑se > no início da linha para criar o bloco.

Sintaxe básica

Citação de uma linha

Coloca > no início da linha:

> Este é um bloco de citação.

Resultado:

Este é um bloco de citação.

Citação multi‑linha

> Esta é a primeira linha da citação.
> Esta é a segunda linha da citação.
> Esta é a terceira linha da citação.

Resultado:

Esta é a primeira linha da citação. Esta é a segunda linha da citação. Esta é a terceira linha da citação.

Parágrafos na citação

Inclui vários parágrafos:

> Este é o primeiro parágrafo da citação.
>
> Este é o segundo parágrafo da citação.

Resultado:

Este é o primeiro parágrafo da citação.

Este é o segundo parágrafo da citação.

Citações aninhadas

Aninhamento básico

Usa >> para aninhar:

> Esta é uma citação de primeiro nível.
>
> > Esta é uma citação de segundo nível.
>
> De volta ao primeiro nível.

Resultado:

Esta é uma citação de primeiro nível.

Esta é uma citação de segundo nível.

De volta ao primeiro nível.

Múltiplos níveis

> Citação de primeiro nível
> > Citação de segundo nível
> > > Citação de terceiro nível
> > > > Citação de quarto nível
> >
> > De volta ao segundo nível
>
> De volta ao primeiro nível

Resultado:

Citação de primeiro nível

Citação de segundo nível

Citação de terceiro nível

Citação de quarto nível

De volta ao segundo nível

De volta ao primeiro nível

Elementos dentro da citação

Formatação

> **Negrito** e *itálico* funcionam normalmente.
> 
> Podes usar `código inline` e outras formatações.

Resultado:

Texto em negrito e texto em itálico funcionam normalmente nas citações.

Podes usar código inline e outras formatações.

Títulos

> ## Título dentro da citação
> 
> Este é o conteúdo.
> 
> ### Subtítulo
> 
> Mais conteúdo.

Resultado:

Título dentro da citação

Este é o conteúdo da citação.

Subtítulo

Mais conteúdo da citação.

Listas

> Lista na citação:
> 
> 1. Item 1
> 2. Item 2
> 3. Item 3
> 
> Ou lista não ordenada:
> 
> - Item A
> - Item B
> - Item C

Resultado:

Lista na citação:

1. Item 1
2. Item 2
3. Item 3

Ou lista não ordenada:

• Item A
• Item B
• Item C

Blocos de código

> Exemplo de código:
> 
> ```javascript
> function hello() {
>   console.log("Hello, World!");
> }
> ```
> 
> Blocos de código funcionam dentro de citações.

Resultado:

Exemplo de código:

function hello() {
  console.log("Hello, World!");
}

Blocos de código funcionam dentro de citações.

Ligações

> Ver [documentação](https://www.markdownlang.com) para saber mais.
> 
> Também: <https://www.markdownlang.com>

Resultado:

Ver documentação para saber mais.

Também: https://www.markdownlang.com

Casos comuns

1) Citação bibliográfica

> "Markdown é uma linguagem de marcação leve que permite escrever em texto simples."
> 
> —— John Gruber, criador do Markdown

Resultado:

"Markdown é uma linguagem de marcação leve que permite escrever em texto simples."

—— John Gruber, criador do Markdown

2) Aviso

> ⚠️ **Aviso**
> 
> Esta ação apaga todos os dados. Garante backup antes.

Resultado:

⚠️ Aviso

Esta ação apaga todos os dados. Garante backup antes.

3) Dica

> 💡 **Dica**
> 
> Usa `Ctrl+S` para guardar rapidamente.

Resultado:

💡 Dica

Usa Ctrl+S para guardar rapidamente.

4) Nota importante

> 📌 **Nota importante**
> 
> Antes de começar, garante que instalaste:
> 
> - Node.js (>= 14.0)
> - npm (>= 6.0)
> - Git

Resultado:

📌 Nota importante

Antes de começar, garante que instalaste:

• Node.js (>= 14.0)
• npm (>= 6.0)
• Git

Erros comuns e soluções

1) Omissão do >

❌ Incorreto:
> Primeira linha
Segunda sem `>`  ← não entra na citação

✅ Correto:
> Primeira linha
> Segunda linha

2) Nível errado de aninhamento

❌ Incorreto:
> Nível 1
> > > Salta ao nível 3

✅ Correto:
> Nível 1
> > Nível 2
> > > Nível 3

3) Linhas em branco

❌ Pode causar problema:
> Primeiro parágrafo

> Segundo parágrafo  ← cria dois blocos

✅ Múltiplos parágrafos na mesma citação:
> Primeiro parágrafo
>
> Segundo parágrafo

Boas práticas

1) Consistência

✅ Recomenda‑se: estilo consistente
> Usa citações para info importante
> Mantém o mesmo formato

❌ Evitar: mistura confusa
> Às vezes citação
**Às vezes só negrito**

2) Aninhar com moderação

✅ Recomenda‑se: aninhamento claro
> Ponto principal
> > Argumento de apoio
> 
> Continuação do ponto principal

❌ Evitar: profundidade excessiva
> > > > > Muito profundo, difícil de ler

3) Semântica

✅ Recomenda‑se: citação com propósito
> Informação importante de fonte credível

❌ Evitar: citação decorativa
> Texto comum — sem necessidade de citação

Saída HTML

Conversão para HTML:

> Isto é um texto citado

Converte para:

<blockquote>
  <p>Isto é um texto citado</p>
</blockquote>

Aninhamento:

> Nível 1
> > Nível 2

Converte para:

<blockquote>
  <p>Nível 1</p>
  <blockquote>
    <p>Nível 2</p>
  </blockquote>
</blockquote>

Estilos personalizados

Alguns processadores suportam estilos personalizados:

Callouts (estilo GitHub)

> [!NOTE]
> Isto é uma nota

> [!WARNING]
> Isto é um aviso

> [!IMPORTANT]
> Isto é importante

Com HTML e CSS

<blockquote style="border-left: 4px solid #3498db; padding-left: 1em; color: #7f8c8d;">
Bloco de citação com estilo personalizado
</blockquote>

Exemplos práticos

Em documentação de API

## Autenticação de utilizador

A autenticação é necessária para aceder à API.

> **Método de autenticação**
> 
> A API usa Bearer Token:
> 
> ```bash
> curl -H "Authorization: Bearer YOUR_TOKEN" \
>      https://api.example.com/users
> ```

### Exemplo de pedido

Faz POST para criar utilizador:

> ```json
> {
>   "name": "João Silva",
>   "email": "joao@example.com",
>   "role": "user"
> }
> ```

Notas em tutoriais

## Passos de instalação

1. Descarrega o instalador
2. Executa o instalador

> ⚠️ **Atenção**
> 
> Antes de instalar, verifica:
> - Desativar antivírus
> - Executar como administrador
> - Ter pelo menos 2GB livres

3. Concluir no assistente

Sintaxe relacionada

• Ênfase
• Listas
• Código
• Ligações

Exercícios

Cria:

1. Um bloco com vários parágrafos
2. Uma citação com três níveis
3. Uma citação técnica com código
4. Um diálogo aninhado