## Referência

Callouts Markdown do GitHub

Publicado em março de 2026

O GitHub adicionou sintaxe de callouts (alertas) ao GitHub Flavored Markdown. Essas caixas estilizadas destacam informações importantes em documentação — notas, dicas, avisos e mais. ShowMeMyMD é um dos poucos visualizadores desktop que os renderiza.

## A Sintaxe

Cinco tipos de callouts

Callouts usam sintaxe de blockquote com uma tag especial na primeira linha. O formato é sempre o mesmo: > [!TYPE] seguido pelo seu conteúdo na próxima linha, também prefixado com >.

> [!NOTE]
> Informações úteis que os usuários devem saber,
> mesmo ao ler por cima.

NOTE — Renderiza como uma caixa azul de informação. Use para contexto adicional que é útil mas não crítico. Pense em informação 'aliás'.

> [!TIP]
> Conselhos úteis para fazer as coisas melhor
> ou mais facilmente.

TIP — Renderiza como uma caixa verde de sugestão. Use para boas práticas, atalhos ou recomendações que facilitam a vida do leitor.

> [!IMPORTANT]
> Informações-chave que os usuários precisam saber
> para alcançar seu objetivo.

IMPORTANT — Renderiza como uma caixa roxa de ênfase. Use para informações críticas de entender antes de prosseguir. Não é um aviso, mas algo que não pode ser pulado.

> [!WARNING]
> Info urgente que precisa de atenção imediata
> do usuário para evitar problemas.

WARNING — Renderiza como uma caixa amarela de alerta. Use para problemas potenciais, pegadinhas ou coisas que podem dar errado se o leitor não tiver cuidado.

> [!CAUTION]
> Alerta sobre riscos ou consequências negativas
> de certas ações.

CAUTION — Renderiza como uma caixa vermelha de perigo. Reserve para operações irreversíveis, cenários de perda de dados ou ações que podem quebrar coisas.

## Dicas de Uso

Escrevendo callouts eficazes

Use com moderação

Muitos callouts criam ruído visual. Se tudo é importante, nada é. Uma página cheia de caixas coloridas treina os leitores a ignorá-las. Um ou dois por seção geralmente é a quantidade certa.

Combine o tipo com a gravidade

Não use CAUTION para uma dica menor. Não use NOTE para algo que pode deletar um banco de dados. A codificação por cores existe para dar aos leitores um sinal instantâneo sobre gravidade — respeite isso.

Mantenha o conteúdo conciso

Callouts funcionam melhor com uma a três frases. Se você precisa de múltiplos parágrafos, a informação provavelmente pertence ao texto principal, não em uma caixa de callout.

Você pode aninhar outros elementos

Código inline, links, negrito e itálico funcionam dentro de callouts. Prefixe cada linha com > para manter o conteúdo dentro do bloco de callout.

## Compatibilidade

Onde os callouts renderizam

Ferramenta	Suporte a Callouts
GitHub (web)	Completo — caixas coloridas com ícones
ShowMeMyMD	Completo — callouts estilizados no desktop
Algumas extensões do VS Code	Varia por extensão
Maioria dos outros visualizadores	Não — mostra um blockquote simples
Renderizadores CommonMark padrão	Não — blockquote simples
Parsers GFM mais antigos	Não — blockquote simples

A maioria dos visualizadores de Markdown mostra apenas um blockquote.

ShowMeMyMD renderiza o callout estilizado completo — barra lateral colorida, ícone e formatação adequada — exatamente como aparece no GitHub. Se você escreve READMEs ou documentação com callouts, esta é uma das poucas maneiras de pré-visualizá-los localmente no Mac.

## Continue Lendo

Saiba mais sobre ShowMeMyMD como visualizador de Markdown para Mac. Veja por que desenvolvedores o escolhem como seu visualizador de Markdown para desenvolvedores. Ou salve nosso Guia Rápido de Markdown.

Pré-visualize callouts localmente

Pare de fazer push no GitHub só para ver como seus callouts ficam. ShowMeMyMD renderiza NOTE, TIP, IMPORTANT, WARNING e CAUTION — direto no seu Mac. $2.99 na Mac App Store.