Callouts no Obsidian: Sintaxe, Tipos, Exemplos e CSS Personalizado

Os callouts (blocos de destaque) do Obsidian permitem destacar, agrupar e ocultar determinados conteúdos dentro de suas notas usando uma sintaxe simples baseada em blocos de citação. Quer você queira chamar a atenção para dicas de estudo, criar listas de tarefas retráteis ou separar notas do autor do texto principal, os callouts oferecem uma forma flexível de organizar informações sem interromper seu fluxo de escrita.

Resposta rápida: Como criar um Callout no Obsidian

Sim. Os callouts do Obsidian são blocos de citação estilizados que usam > [!type] na primeira linha. Este guia oferece a sintaxe, exemplos prontos para copiar e colar, tipos nativos, regras de recolhimento e aninhamento, além de correções para problemas comuns de CSS personalizado. Consulte a referência oficial de callouts para verificar a lista atual de tipos e comandos do editor.

Aqui está a sintaxe básica para criar um callout:

> [!note] Este é um callout.

• Use > [!type] na primeira linha de um bloco de citação

• Substitua note por outro tipo como tip, warning ou question

• Pressione Enter e continue com > para adicionar conteúdo multilinha

• Na Visualização ao Vivo (Live Preview), use a paleta de comandos e selecione Insert callout para inserir instantaneamente um bloco padrão. Você também pode selecionar um texto existente e executar o mesmo comando para envolvê-lo em um callout.

O que são Callouts no Obsidian?

Callouts são blocos de citação com estilo que o Obsidian renderiza com cores, ícones e comportamento retrátil opcional. Eles foram introduzidos em meados de 2022 e se tornaram um recurso essencial para a organização visual de notas.

Quando o Obsidian encontra um bloco de citação começando com [!type], ele o processa de forma especial e exibe uma caixa em destaque em vez de uma citação comum. Dentro do corpo, você pode usar a sintaxe Markdown padrão, wikilinks, elementos incorporados, tarefas, blocos de código e links internos.

Visualmente, um callout exibe uma barra lateral colorida, um ícone (como uma lâmpada para dicas ou um ponto de exclamação para avisos), uma barra de título opcional e o texto do corpo abaixo.

Usos comuns incluem:

• Resumir pontos-chave no topo de notas de reunião

• Destacar material de estudo importante

• Adicionar caixas de spoiler em anotações de livros

Observe que os callouts são renderizados com essa formatação apenas dentro do Obsidian. Em leitores de Markdown simples ou no GitHub, eles aparecem como blocos de citação aninhados comuns — o conteúdo permanece legível, apenas sem o estilo visual.

Sintaxe e configuração de Callouts

Esta seção cobre todos os elementos de sintaxe: tipo, título, recolhimento e conteúdo do corpo.

A estrutura básica é a seguinte:

> [!note] Texto do título
> O conteúdo do corpo vai aqui
> - Tópicos também funcionam

A primeira linha contém três partes:

• Identificador de tipo entre colchetes: [!note], [!warning], [!tip]

• Marcador retrátil opcional: + ou - diretamente após o tipo (ex: [!tip]-)

• Título personalizado opcional após o tipo (ex: [!tip] Dica para a prova)

As linhas do corpo começam com > como blocos de citação normais e podem incluir listas, blocos de código, imagens ou caixas de seleção de tarefas.

A palavra-chave do tipo não diferencia maiúsculas de minúsculas — [!NOTE], [!Note] e [!note] funcionam de maneira idêntica para callouts nativos.

Alterando títulos de Callouts

Por padrão, o Obsidian usa o nome do tipo como título (ex: “Note” ou “Warning”).

Para substituir o título padrão:

> [!warning] Leia isto antes de implantar

Compare estas duas abordagens:

• > [!tip] exibe o cabeçalho padrão “Tip”

• > [!tip] Fluxo de trabalho mais rápido exibe “Fluxo de trabalho mais rápido” em seu lugar

Um callout contendo apenas título também funciona — use apenas uma linha como > [!info] Requisitos do sistema sem linhas de corpo abaixo.

Títulos podem conter emojis, wikilinks e formatações como texto em negrito.

Callouts Retráteis (Desdobráveis)

Adicionar um sinal de mais ou menos diretamente após o tipo controla se o callout pode ser recolhido:

• > [!note]+ Sempre expandido por padrão

• > [!note]- Recolhido por padrão

Ambos os marcadores tornam o callout retrátil. O sinal determina se ele começa aberto ou fechado.

Aplicações práticas para callouts retráteis incluem:

• Ocultar soluções detalhadas em notas de estudo

• Recolher longas listas de verificação sob um cabeçalho [!todo]-

• Esconder spoilers em anotações de leitura

Nos modos de Leitura e Live Preview, os usuários clicam no ícone de triângulo para expandir ou recolher. No modo Código-Fonte, o marcador aparece como Markdown simples.

Callouts Aninhados

Você pode aninhar callouts colocando outro bloco de callout dentro do corpo de um callout principal.

As linhas do callout interno usam um > adicional para cada nível de aninhamento:

> [!warning] Problema potencial
>> [!tip] Aqui está uma solução alternativa

Isso cria um callout de aviso contendo uma dica aninhada. Outro exemplo: um [!question] com respostas [!example] aninhadas.

Limite a profundidade de aninhamento para manter a legibilidade — dois níveis geralmente são suficientes.

Tipos de Callouts suportados no Obsidian

O Obsidian vem com tipos nativos, cada um associado a uma cor e um ícone. Tipos não suportados adotam por padrão o estilo de note.

Tipos padrão comuns e seus aliases:

• note: informações gerais

• abstract / summary / tldr: resumos

• info: contexto adicional

• todo: tarefas e itens de ação

• tip / hint / important: conselhos e pontos principais

• success / check / done: itens concluídos

• question / help / faq: perguntas

• warning / caution / attention: problemas potenciais

• failure / fail / missing: informações ausentes

• danger / error: problemas graves

• bug: erros de software

• example: exemplos conceituais ou de código

• quote / cite: citações em destaque

Diferentes temas da comunidade podem estilizar esses tipos, portanto o mesmo [!warning] pode ter uma aparência diferente dependendo do tema.

Na Live Preview, clique com o botão direito na barra lateral de um callout para alterar seu tipo a partir de um menu de contexto em vez de editar o Markdown manualmente.

Tipos desconhecidos como [!idea] são exibidos visualmente como note, mas permanecem disponíveis para personalização via CSS.

Qual Callout você deve usar?

O tipo controla o sinal, não apenas a cor. Adote uma convenção simples que informe o que fazer ao escanear a nota mais tarde:

O que você precisa sinalizar	Bom tipo inicial	Padrão útil
Contexto ou uma definição	info ou abstract	Coloque a explicação ao lado da afirmação que ela apoia.
Uma próxima ação	todo	Mantenha a lista de verificação próxima ao contexto do projeto.
Uma decisão ou risco	question, warning ou tipo próprio	Torne o ponto em aberto visível sem enterrá-lo no texto.
Um detalhe secundário	Retrátil example ou note	Use - para manter detalhes recolhidos por padrão.
Um resultado concluído	success ou done	Reserve para um resultado real, não para cada frase positiva.

Para um vault de produtividade, um conjunto mínimo prático é todo para ações, warning para impedimentos, question para decisões abertas e summary para notas de revisão.

Formas práticas de usar Callouts em seu vault

Veja como os callouts se encaixam em fluxos de trabalho reais:

• Estudos e aprendizado: Use [!tip] para dicas de exames, [!question]- para perguntas de prática com soluções recolhidas, [!summary] no topo de notas de aula.

• Desenvolvimento de software: Adicione [!warning] em torno de comandos destrutivos, [!bug] para problemas conhecidos, [!example] para trechos de código de API.

• Gestão de projetos e tarefas: Armazene listas de verificação em callouts [!todo]+ agrupados por etapa, convertendo para [!success] ao finalizar.

• Escrita de artigos e livros: Separe notas do autor usando [!note]- ou tipos personalizados, marque pistas de enredo como [!clue] em rascunhos.

• Base de conhecimento pessoal: Use [!info] para fatos principais, [!quote] para citações, [!danger] para avisos críticos.

Combine callouts com modelos prontos para Obsidian. Para fluxos de reuniões, veja nosso guia de modelos de reunião no Obsidian.

Callouts para Tarefas e Listas de Verificação

Tarefas dentro de callouts se comportam como tarefas normais do Obsidian e aparecem na busca global de tarefas.

Um callout [!todo] agrupa caixas de seleção relacionadas:

> [!todo]+ Lista de verificação da versão 1.2
> - [ ] Atualizar CHANGELOG para a versão de 01/04/2025
> - [ ] Executar testes de regressão

Altere o tipo de todo para success para sinalizar visualmente a conclusão de um bloco inteiro.

Callouts em Fluxos de Publicação

Callouts são ferramentas de edição interna e frequentemente não devem aparecer em exportações finais como livros, PDFs ou posts de blog.

Plugins como o Longform permitem adicionar uma etapa de pré-processamento para remover a marcação de callouts antes de compilar. Um script busca linhas começando com > [! e remove a estrutura mantendo ou descartando o corpo.

Personalizando Callouts com CSS

O Obsidian expõe callouts via atributos data-callout, permitindo definir tipos personalizados com CSS próprio.

O padrão:

1. Escolha um identificador de tipo personalizado como idea

2. Use em notas: > [!idea] Novo conceito de produto

3. No CSS, direcione a .callout[data-callout="idea"] com cores e ícone próprios.

O Obsidian usa ícones Lucide. A API CSS suportada utiliza --callout-color e --callout-icon; a referência para desenvolvedores sobre variáveis CSS de callout lista as variáveis disponíveis.

Exemplos de Callouts Personalizados Úteis

Ideias concretas de tipos personalizados:

• [!clue]: Para escritores acompanharem pistas do enredo entre capítulos.

• [!risk]: Em documentações técnicas para sinalizar riscos técnicos ou de negócios.

• [!meeting]: Para resumos de ações no topo de notas de reunião datadas.

• [!definition]: Em uma base de conhecimento para padronizar definições de termos.

Adicione esses estilos incluindo um snippet CSS na pasta .obsidian/snippets do seu vault.

Solução de problemas de CSS

Verifique na seguinte ordem:

1. Coloque o arquivo CSS na pasta .obsidian/snippets do vault, ative em Configurações → Aparência → Snippets CSS e recarregue os snippets.
2. Garanta que o tipo na nota e no seletor coincidam exatamente. Por exemplo, [!decision] exige .callout[data-callout="decision"].
3. Mantenha os nomes de tipos personalizados em minúsculas em ambos os lugares. Os identificadores integrados não diferenciam maiúsculas de minúsculas, mas um relatório de solução de problemas do fórum do Obsidian mostra que uma diferença de maiúsculas e minúsculas pode impedir que um seletor personalizado corresponda.
4. Use um ícone incluído na sua versão do Obsidian.

Pesquisando, Gerenciando e Exportando Callouts

Busque callouts usando pesquisas como "[!todo]" para encontrar todos os callouts de tarefas. Combine com filtros de caminho: path:"Drafts" "[!clue]".

Limitações e Compatibilidade

Os callouts não fazem parte do CommonMark padrão. Em editores como o Typora ou no GitHub, eles se degradam para citações simples aninhadas.

Alguns aplicativos Markdown móveis os exibem como texto simples — o conteúdo permanece legível, mas sem cores ou ícones.

O uso intenso de callouts aninhados e retráteis pode desacelerar a renderização em dispositivos móveis mais antigos.

Teste periodicamente as exportações (PDF, DOCX, HTML) para verificar se o conteúdo crítico dentro dos callouts é exibido corretamente. Considere manter um documento de guia de estilo em seu vault para que os colaboradores sigam as mesmas convenções.

Erros de sintaxe comuns

O marcador de recolhimento deve encostar no identificador de tipo:

> [!faq]- Recolhido por padrão
> Este conteúdo começa oculto.

> [!faq] - Recolhido por padrão tem um espaço antes do hífen, portanto não é a sintaxe de recolhimento documentada. Se o recolhimento ainda não funcionar, verifique se a nota está na Visualização de Leitura ou Live Preview e compare o bloco com o exemplo oficial. Um relatório do fórum do Obsidian de 2024 identificou o espaço extra como a causa de um callout que não se recolhia.

Os callouts são uma extensão do Obsidian, não CommonMark padrão. Se um callout parecer uma citação simples em outro editor Markdown, isso é esperado; o conteúdo permanece legível, mas o estilo e o comportamento de recolhimento do Obsidian podem não ser transferidos.

Conclusão

Os callouts do Obsidian são blocos de citação aprimorados que permitem destacar, agrupar e opcionalmente ocultar informações sem interromper seu fluxo de notas.

Principais conclusões:

• Domine a sintaxe básica: > [!type] Título

• Escolha um pequeno conjunto de tipos que se adeque ao seu fluxo de trabalho

• Adicione CSS personalizado apenas onde ele apoie seu processo

Se você deseja ter suas notas diárias, projetos, revisões e modelos de reunião conectados desde o início, o Obsibrain oferece um sistema local pronto para uso no Obsidian.