Markdown Blockquotes explicado: o guia completo para cotações
O guia completo para markdown blockquotes. Aprenda a sintaxe, o aninhamento, os alertas do GitHub, as chamadas do Obsidian, o estilo, a compatibilidade da plataforma e todos os outros casos de uso que você encontrar.
Uma citação em bloco é uma forma de destacar um texto que vem de outra fonte ou que precisa de ênfase extra, como uma citação, nota ou exemplo. No Markdown, aspas em bloco são fáceis de criar com um símbolo simples, o que as torna úteis para escritores, blogueiros, estudantes e qualquer pessoa que publique conteúdo online. Este guia mostrará o que são blockquotes e como usá-las corretamente no Markdown.
Resposta rápida: Como você cria um Blockquote no Markdown?
Para criar uma citação de bloco no markdown, adicione um sinal de maior que (>) seguido de um espaço no início de qualquer linha. A linha inteira se torna um bloco entre aspas.
> This is a blockquote.
Renderiza como:
Esta é uma citação em bloco.
Essa é toda a sintaxe básica. O restante deste guia cobre cotações multilinhas, aninhamento, alertas do GitHub, textos explicativos da Obsidian, estilo, compatibilidade de plataforma e todos os outros casos de uso que você encontrar. Para uma referência mais ampla, consulte nossa folha de cheats de markdown completa.
Sintaxe básica de Blockquote em Markdown
Cada citação de bloco de redução começa com > no início de uma linha.
> This is a single-line blockquote.
Renderiza como:
Esta é uma citação em bloco de uma linha.
O espaço após > é opcional, mas recomendado. Ambos funcionam de forma idêntica na maioria dos analisadores:
> With a space
>Without a space
Para máxima compatibilidade, especialmente em analisadores CommonMark mais rígidos, sempre inclua o espaço.
Por que o caractere >? Markdown emprestou sua sintaxe de blockquote das convenções de e-mail. Quando você responde a um e-mail, o texto citado geralmente é prefixado com >. Gruber manteve a convenção porque ela já era familiar para quem usava e-mail desde a década de 1980.
Cotações multilinhas em Markdown
Várias linhas no mesmo parágrafo
Adicione > ao início de cada linha:
> This is line one of the blockquote.
> This is line two.
> This is line three.
Renderiza como um único parágrafo:
Esta é a linha um do blockquote. Esta é a linha dois. Esta é a linha três.
Continuação preguiçosa (não recomendada)
Alguns analisadores permitem eliminar > nas linhas de continuação:
> This is line one.
This is line two (lazy style).
Isso funciona no CommonMark e no GitHub Flavored Markdown, mas alguns analisadores falham. Sempre prefixe cada linha com > para compatibilidade.
Citações em bloco com vários parágrafos
Para vários parágrafos dentro de uma única citação, separe-os com uma linha contendo apenas >:
> This is the first paragraph of the blockquote.
>
> This is the second paragraph. Notice the blank `>` line above.
>
> And this is a third paragraph.
Renderiza como:
Este é o primeiro parágrafo da citação.
Este é o segundo parágrafo. Observe a linha
>em branco acima.E este é um terceiro parágrafo.
Regra crítica: A linha em branco entre os parágrafos ainda deve ter um caractere >. Sem ele, o blockquote termina e um novo começa, o que geralmente não é o que você deseja.
Citações de Markdown aninhadas
Empilhe caracteres > para aninhar aspas uns dentro dos outros:
> This is the first-level quote.
>
> > This is a nested quote inside the first one.
> >
> > > And this is nested three levels deep.
>
> Back to the first level.
Renderiza como:
Esta é a cotação de primeiro nível.
Esta é uma citação aninhada dentro da primeira.
E isso está aninhado em três níveis de profundidade.
De volta ao primeiro nível.
O aninhamento é comum em cadeias de resposta no estilo e-mail, onde cada nível de > representa outra rodada de cotação. Na prática, ir mais fundo do que dois ou três níveis torna-se difícil de ler, então considere reestruturar o conteúdo antes de aninhar quatro níveis de profundidade.
Formatando dentro de citações de Markdown
Blockquotes pode conter a maioria dos outros elementos de redução. Coloque cada elemento em sua própria linha, ainda prefixado com >.
Formatação de texto
> You can use **bold**, *italic*, ***bold italic***,
> ~~strikethrough~~, and `inline code` inside blockquotes.
Renderiza como:
Você pode usar negrito, itálico, negrito itálico,
tachado, ecódigo embutidodentro de blockquotes.
Títulos
> ### This is a heading inside a blockquote
>
> And this is regular text below it.
Renderiza como:
### Este é um título dentro de uma citação
E este é o texto normal abaixo dele.
Listas
As listas ordenadas e não ordenadas funcionam:
> **Quarterly Review:**
>
> - Revenue grew 23%
> - Headcount increased by 12
> - Customer churn dropped to 3%
>
> *All metrics are trending in the right direction.*
Renderiza como:
Revisão Trimestral:
- Receita cresceu 23%
- Número de funcionários aumentado em 12
- A rotatividade de clientes caiu para 3%
Todas as métricas estão tendendo na direção certa.
Blocos de código
Blocos de código protegidos funcionam dentro de blockquotes, mas cada linha ainda precisa do prefixo >:
> Run the following command to install:
>
> ```festa
> npm install markdown-it
>```
>
> Then restart your application.
Links e imagens
> For more info, visit [our documentation](https://example.com).
>
> 
O que não funciona de maneira confiável
- Tabelas dentro de blockquotes funcionam no GitHub Flavored Markdown, mas falham em analisadores mais rígidos. Teste antes de confiar neles.
- Regras horizontais dentro de blockquotes (
---) são ambíguas e renderizadas de forma inconsistente. - Elementos de bloco HTML dentro de blockquotes se comportam de maneira imprevisível entre analisadores.
Alertas do GitHub (notas, avisos, dicas)
GitHub Flavored Markdown (GFM) estende a sintaxe de blockquote com cinco tipos de alerta especiais que são renderizados com cores e ícones distintos no GitHub, GitHub Issues, READMEs e pull requests.
Sintaxe
> [!NOTE]
> Useful information that users should know, even when skimming.
> [!TIP]
> Helpful advice for doing things better or more easily.
> [!IMPORTANT]
> Key information users need to know to achieve their goal.
> [!WARNING]
> Urgent info that needs immediate user attention to avoid problems.
> [!CAUTION]
> Advises about risks or negative outcomes of certain actions.
Regras para alertas do GitHub
- O tipo de alerta (
[!NOTE],[!TIP], etc.) deve estar em sua própria linha no início do blockquote. - Os tipos de alerta diferenciam maiúsculas de minúsculas,
[!note]não funcionará. - O alerta se aplica a todo o blockquote a seguir.
- Apenas um tipo de alerta por blockquote. A mistura de tipos não é suportada.
Quando usar cada tipo
| Alerta | Usar para |
|---|---|
[!NOTE] |
Contexto útil que não é crítico, mas ajuda o leitor |
[!TIP] |
Conselhos opcionais que tornam algo mais fácil ou melhor |
[!IMPORTANTE] |
Informações que o leitor deve saber para ter sucesso |
[!AVISO] |
Algo que pode dar errado se for ignorado |
[!CAUÇÃO] |
Riscos graves, perda de dados, problemas de segurança, ações irreversíveis |
Os alertas do GitHub funcionam em READMEs de repositório, páginas wiki, problemas, pull requests e discussões. Eles não são renderizados como alertas fora do GitHub; em outros lugares, eles voltam para aspas regulares com o texto [!NOTE] visível como texto simples.
Chamadas de Obsidiana
Obsidian usa uma sintaxe semelhante aos alertas do GitHub, mas com muito mais opções. A sintaxe é > [!type] seguida de conteúdo:
> [!note] Custom title here
> This is a note callout with a custom title.
> [!warning]
> This is a warning callout.
> [!tip] Pro tip
> Callouts can have custom titles for extra context.
Tipos de texto explicativo Obsidiana
Obsidian oferece suporte a mais de uma dúzia de tipos de texto explicativo, cada um com cores e ícones distintos:
nota,info,resumo,resumo,tldrdica,dica,importantesucesso,verificar,concluídopergunta,ajuda,faqaviso,cuidado,atençãofalha,falha,ausenteperigo,errobugexemplocitar,citar
Chamadas dobráveis
Adicione um + ou - após o tipo para tornar os textos explicativos dobráveis:
> [!note]+ Click to expand (starts open)
> Content hidden behind a toggle.
> [!warning]- Click to expand (starts closed)
> Collapsed by default.
Chamadas aninhadas
As frases de destaque podem ser aninhadas como aspas normais:
> [!note] Outer callout
> This is the outer content.
>
> > [!tip] Inner callout
> > This is nested inside.
Os textos explicativos do Obsidian são o motivo pelo qual muitos usuários de descontos preferem o Obsidian para fazer anotações. Eles transformam citações simples em caixas de informações ricas e estilizadas.
Quando usar citações em bloco
Blockquotes são versáteis. Aqui estão as cinco situações mais comuns em que você os usará, com exemplos para ajudá-lo a entender.
1. Citando Outra Pessoa
O propósito original. Atribua as citações à sua fonte com uma linha para atribuição:
> The best way to predict the future is to invent it.
>
> Alan Kay
Renderiza como:
A melhor maneira de prever o futuro é inventá-lo.
Alan Kay
Estilo acadêmico com citação adequada:
> Markdown is a text-to-HTML conversion tool for web writers. Markdown
> allows you to write using an easy-to-read, easy-to-write plain text
> format, then convert it to structurally valid XHTML (or HTML).
>
> John Gruber, [Daring Fireball](https://daringfireball.net/projects/markdown/)
2. Obtenha citações em conteúdo longo
Retire uma frase memorável do corpo do texto para chamar a atenção visual:
The team shipped the feature in record time. Morale soared. Revenue followed.
> In three months, we went from zero users to forty thousand.
What made the difference wasn't the code, it was the timing.
3. Textos explicativos e notas
Antes da existência dos alertas do GitHub, as pessoas usavam citações em negrito para criar frases de destaque:
> **Note:** This feature requires Node.js 18 or higher.
> **Warning:** Running this command will delete all data in the database.
> **Tip:** You can skip the setup step by using the `--auto` flag.
Ainda amplamente utilizado em plataformas que não suportam alertas do GitHub.
4. Respostas e citações em estilo de e-mail
Em discussões, problemas e pull requests:
> Should we use PostgreSQL or MySQL for this?
PostgreSQL, better JSON support and stronger type system.
5. Citações com fontes
Para redação acadêmica, jornalística ou técnica:
> 78% of developers report using markdown daily.
>
> An interesting article on markdown, 2025
Estilizando citações em bloco com CSS
O markdown puro não tem opções de estilo. Blockquotes são renderizados da maneira que a plataforma decidir. A maioria dos renderizadores usa borda esquerda, texto cinza e algum preenchimento por padrão.
Estilo personalizado em seu próprio site
Se você publicar markdown em um site que você controla (Jekyll, Hugo, Ghost, Next.js e similares), substitua o CSS <blockquote>:
blockquote {
border-left: 4px solid #3498db;
padding: 1em 1.5em;
margin: 1.5em 0;
background: #f8f9fa;
font-style: italic;
color: #555;
}
blockquote p:last-child {
margin-bottom: 0;
}
HTML embutido substituto
Quando você precisa de um estilo de blockquote específico dentro do markdown e a plataforma permite HTML bruto:
<blockquote style="border-left: 4px solid #e74c3c; padding-left: 1em; color: #666;">
This is a custom-styled quote.
</blockquote>
Isso funciona no GitHub, na maioria dos geradores de sites estáticos e no Ghost. Não funciona no Reddit, Discord ou Slack (que remove o HTML embutido).
Compatibilidade de plataforma
Blockquotes são um dos recursos de redução com suporte universal. Eles funcionam em quase todos os lugares, mas vale a pena conhecer variações específicas da plataforma.
| Platform | Blockquotes | Nested | GitHub Alerts | Callouts |
| -------------- | :---------: | :----: | :-----------: | :---------- |
| GitHub (GFM) | Yes | Yes | Yes | No |
| GitLab | Yes | Yes | Partial | No |
| Bitbucket | Yes | Yes | No | No |
| Reddit | Yes | Yes | No | No |
| Discord | Yes | No | No | No |
| Slack | Yes | No | No | No |
| Notion | Yes | Yes | No | No |
| Obsidian | Yes | Yes | As callout | Yes |
| Stack Overflow | Yes | Yes | No | No |
| Jekyll / Hugo | Yes | Yes | Via plugin | No |
Notas específicas da plataforma
Discord oferece suporte a aspas de linha única e multilinha, mas não oferece suporte a aninhamento. Use > para uma única linha ou >>> no início para uma cotação de várias linhas que continua até o final da mensagem.
Slack renderiza > como aspas, mas não suporta aninhamento. Aspas multilinhas requerem > em cada linha.
Reddit requer uma linha em branco antes de qualquer citação em bloco para ser renderizada. Este é o motivo mais comum pelo qual as citações em bloco falham no Reddit.
Notion converte automaticamente a entrada > em seu próprio bloco Quote. Aspas aninhadas exigem arrastar blocos uns para os outros.
Para mais peculiaridades da plataforma, consulte nosso guia de compatibilidade completo na folha de dicas do pilar.
Erros e correções comuns
1. Blockquote não renderiza
Causa: Falta uma linha em branco antes ou depois da citação.
Quebrado:
Here is regular text.
> This should be a blockquote.
More text.
Fixo:
Here is regular text.
> This should be a blockquote.
More text.
A maioria dos analisadores perdoa isso, mas os mais rígidos (incluindo o Reddit) exigem linhas em branco em ambos os lados.
2. A citação em bloco de vários parágrafos se divide em duas
Causa: A linha em branco entre os parágrafos não possui um >.
Quebrado:
> First paragraph.
> Second paragraph (this becomes a separate blockquote).
Fixo:
> First paragraph.
>
> Second paragraph (now part of the same blockquote).
A linha separadora em branco ainda deve conter >.
3. O alerta do GitHub é renderizado como uma citação simples
Causa: a tag de alerta está na linha errada, está incorreta ou tem espaços extras.
Quebrado:
> [!note]
> This is a note.
O tipo deve ser maiúsculo:
Fixo:
> [!NOTE]
> This is a note.
Verifique também se a tag está em sua própria linha, sem nada depois dela na mesma linha.
4. Blockquote aninhado é recolhido para um único nível
Causa: Caracteres > ausentes ou inconsistentes em linhas aninhadas.
Quebrado:
> Outer quote.
>> Nested quote.
Espaço faltando entre > e >:
Fixo:
> Outer quote.
>
> > Nested quote.
Sempre coloque um espaço entre cada caractere > ao aninhar e inclua uma linha > em branco antes de aninhar.
5. Bloco de código dentro de quebras de blockquote
Causa: > faltando nas linhas da cerca.
Quebrado:
> Here's some code:
```javascript
console.log("olá");```
> Back to the quote.
Fixo:
> Here's some code:
>
> ```javascript
> console.log("olá");
>```
>
> Back to the quote.
Cada linha, incluindo as linhas da cerca, precisa do prefixo >.
6. Linhas de continuação preguiçosas são renderizadas como parágrafo regular
Causa: O analisador não suporta continuação lenta.
Arriscado:
> First line of the quote.
Second line without >.
Sempre seguro:
> First line of the quote.
> Second line with >.
Práticas recomendadas de Markdown Blockquote
Blockquotes são um dos recursos de redução mais versáteis. Eles oferecem suporte a tudo, desde cotações simples até chamadas e alertas complexos.
Quando algo não for renderizado conforme o esperado, verifique as regras comuns de formatação acima. A maioria dos problemas vem da falta de caracteres > ou problemas de espaçamento.
Perguntas frequentes
O que é um blockquote no markdown?
Uma citação em bloco é um bloco de texto visualmente separado do conteúdo circundante, geralmente com uma borda esquerda, preenchimento e, às vezes, texto em itálico ou silenciado. No markdown, qualquer linha que comece com > torna-se parte de um blockquote.
Posso aninhar citações em markdown?
Sim. Adicione outro > para cada nível de aninhamento, > > para dois níveis, > > > para três e assim por diante. Sempre coloque um espaço entre cada caractere >.
Como faço para encerrar uma citação em bloco?
Deixe uma linha em branco (sem >) após a última linha citada. A próxima linha de texto será um parágrafo normal.
Posso colocar blocos de código dentro de uma citação?
Sim. Use blocos de código protegidos (crases triplos) e prefixe cada linha, incluindo as linhas da cerca, com >.
Por que meu alerta do GitHub não aparece colorido?
Os alertas do GitHub são renderizados apenas no próprio GitHub (incluindo problemas do GitHub, pull requests, wikis e READMEs). Fora do GitHub, eles voltam para aspas regulares com o texto [!NOTE] visível. Verifique também se o tipo de alerta está em letras maiúsculas e em sua própria linha.
Qual é a diferença entre uma citação em bloco e uma frase de destaque?
Uma citação em bloco é uma marcação padrão (>). Uma chamada é uma variante de estilo, os alertas do GitHub e as chamadas Obsidian usam a sintaxe blockquote com uma tag extra ([!NOTE], [!warning]) para acionar um estilo especial. As chamadas são extensões da plataforma, não remarcações principais.
Como faço para citar alguém e adicionar atribuição?
Adicione uma linha após a citação com a fonte:
> Premature optimization is the root of all evil.
>
> Donald Knuth
Posso estilizar citações com cores personalizadas?
Não com o markdown puro, as citações em bloco herdam qualquer estilo que a plataforma aplique. Em um site que você controla, substitua o CSS <blockquote>. Dentro do conteúdo markdown, use HTML bruto com estilos embutidos se a plataforma permitir.
As citações em bloco funcionam em todos os tipos de descontos?
Sim. Blockquotes fazem parte da especificação original de John Gruber e são suportados por todos os analisadores de markdown, incluindo CommonMark, GFM, MultiMarkdown, Pandoc e variantes de plataforma como Discord, Slack e Reddit.
Por que meu blockquote quebra no Reddit?
O Reddit requer uma linha em branco antes de qualquer citação. Além disso, a marcação do Reddit é mais rigorosa que a do GFM, se o > não começar no início de uma linha (sem espaços à esquerda), ele não será renderizado.
Posso ter uma citação vazia?
Tecnicamente sim, > em sua própria linha produz um bloco vazio entre aspas, mas raramente é útil. A maioria dos analisadores apenas renderiza uma borda fina sem conteúdo.
Qual deve ser o tamanho de uma citação em bloco?
Não há limite técnico. Estilisticamente, citações curtas (uma ou duas frases) funcionam bem como citações pull. Citações mais longas (um parágrafo ou mais) funcionam para citações extensas. Se uma citação durar mais do que alguns parágrafos, considere parafrasear ou resumir.