Citações em bloco no Markdown: citações, vários parágrafos e listas

Uma citação em bloco no Markdown começa com > seguido de um espaço. Coloque o marcador no início de cada linha citada para manter o código-fonte fácil de ler e editar.

> O guia de instalação atualizado está pronto para revisão.

O resultado é um parágrafo citado, não um bloco de código. A borda, o recuo e a cor dependem do tema da página ou do documento. O texto da citação continua sendo Markdown comum, então pode conter ênfase, links, listas e outras estruturas do documento.

Use o visualizador de Markdown para experimentar os exemplos e depois exporte o documento com o conversor de Markdown para Word quando precisar de uma cópia editável para revisão.

Cite um parágrafo em várias linhas do arquivo-fonte

Para uma citação mais longa, repita o marcador:

> O guia de instalação atualizado está pronto para revisão.
> Confira os pré-requisitos antes de aprovar a publicação.

Essas duas linhas do arquivo-fonte formam um único parágrafo na prévia deste site. Uma quebra no código-fonte não força necessariamente uma quebra de linha na exibição. Quando o texto precisar permanecer em duas linhas, adicione uma quebra explícita:

> Revisão da documentação\
> Atribuída à pessoa responsável pela versão

A barra invertida fica antes da quebra de linha; a próxima linha ainda começa com o marcador de citação. Veja quebras de linha em Markdown para entender a diferença entre quebras forçadas e separações de parágrafo.

Inclua vários parágrafos em uma citação

Coloque um marcador de citação na linha que, de outra forma, ficaria vazia entre os parágrafos:

> O primeiro rascunho descreve o processo de instalação.
>
> O segundo acrescenta etapas de solução de problemas e exemplos.

Isso cria uma única citação em bloco com dois parágrafos. Manter > na separação torna o agrupamento desejado visível, principalmente quando outra pessoa editar o trecho mais tarde.

Para retomar seu próprio texto, deixe uma linha em branco e continue sem o marcador:

> A revisão solicitou uma seção de instalação mais curta.

Movemos as notas detalhadas de configuração para um apêndice.

Evite remover > de uma linha de continuação sem adicionar uma linha em branco. Alguns analisadores Markdown tratam isso como uma continuação implícita do parágrafo citado. A especificação de citações em bloco do CommonMark descreve esse comportamento. Marcadores explícitos e uma linha vazia clara facilitam a manutenção entre colaboradores.

Adicione ênfase, links e atribuição

O conteúdo de uma citação pode usar a formatação em linha normal:

> **Nota de revisão:** As etapas de migração precisam de um exemplo funcional.
> Veja a [lista de verificação da versão](https://example.com/checklist).
>
> Comentários da revisão de documentação, setembro de 2026.

O Markdown não atribui uma função especial de referência bibliográfica à última linha. Ela é conteúdo comum de parágrafo dentro da citação. Inclua a fonte, o autor e o link quando forem necessários e verifique as permissões antes de reproduzir um trecho de outra pessoa.

Uma citação em bloco também não adiciona aspas literais. Digite as aspas se o documento final precisar delas. Para uma citação curta integrada à sua própria frase, aspas comuns podem bastar sem criar um bloco separado.

Aninhe uma citação ou inclua uma lista

Use outro nível de > para material citado dentro da citação externa:

> A pessoa responsável pela revisão resumiu a solicitação anterior:
>
> > Adicione um exemplo completo do arquivo de configuração.
>
> O rascunho atualizado agora inclui esse exemplo.

Limite os níveis de aninhamento em um relatório. Citações muito aninhadas reduzem a largura disponível para o texto, o que pode dificultar a leitura dos layouts em PDF e Word.

Uma lista dentro de uma citação mantém o marcador em todas as linhas:

> A revisão identificou duas alterações:
>
> - Explicar as permissões necessárias.
> - Adicionar uma seção de solução de problemas.

Para a estrutura oposta, uma citação dentro de uma lista, aplique recuo abaixo do texto do item:

- Comentários sobre a documentação

  > Adicione uma seção de solução de problemas antes da publicação.
- Lista de verificação da versão

Se a citação aparecer fora do item, compare o recuo com os exemplos do guia de recuo em Markdown.

Alertas do GitHub precisam de suporte no destino

O GitHub aceita alertas especiais baseados na sintaxe de citações, incluindo esta forma:

> [!NOTE]
> Faça uma cópia de segurança da configuração antes de alterá-la.

O GitHub documenta os tipos aceitos na referência de alertas. As cores e os ícones de alerta são recursos da plataforma, não propriedades de todas as citações Markdown.

O renderizador deste site não aplica o estilo de alerta do GitHub. O exemplo permanece como uma citação em bloco com o rótulo [!NOTE] visível. Para um documento que precise ficar legível em diferentes destinos, use um rótulo explícito em negrito:

> **Nota:** Faça uma cópia de segurança da configuração antes de alterá-la.

Isso mantém o significado compreensível sem uma extensão especial de alertas. A mesma abordagem funciona para um aviso, uma decisão de revisão ou uma nota editorial.

Resolva problemas nas citações antes de exportar

Se > aparecer literalmente, verifique se o exemplo está entre crases, dentro de um bloco de código delimitado ou em um bloco de código com recuo. Esses contextos servem para exibir o texto-fonte. Uma barra invertida antes do marcador também o escapa.

Se texto demais for incluído na citação, adicione uma linha em branco antes do parágrafo que deve continuar fora dela. Se o material aninhado estiver difícil de acompanhar, reduza o aninhamento e adicione a atribuição como um parágrafo comum.

Por fim, abra o DOCX exportado e examine citações longas e listas citadas. A borda esquerda do navegador e o estilo de parágrafo de um documento Word podem ser diferentes. Use a ferramenta de Markdown para HTML para inspecionar a estrutura intermediária quando precisar distinguir um problema de formatação da fonte de um problema de estilo na exportação.