Obsidian Dataview: O Guia Completo para Dashboards Dinâmicos e Consultas (2026)

O verdadeiro poder do Obsidian não está nas notas que você escreve — mas no que acontece quando essas notas começam a conversar entre si. O Dataview é o plugin que ativa essa transformação. Ele transforma o seu cofre (vault) de uma pilha de arquivos markdown estáticos num banco de dados vivo que você pode consultar, ordenar e resumir a qualquer momento. Etiquete uma nota, adicione uma data de vencimento, defina o status de um projeto e o Dataview reúne essas informações em tabelas, listas e dashboards que se atualizam automaticamente sempre que você altera algo.

Se você já percorreu uma dúzia de pastas procurando por “todos os meus projetos ativos” ou “todas as tarefas que ainda devo a alguém”, já entende o problema que o Dataview resolve. Em vez de manter notas de índice manualmente, você escreve uma consulta curta uma vez e deixa o plugin mantê-la atualizada para sempre. O seu registo de leitura, o seu painel de tarefas, a sua revisão semanal — tudo isso pode tornar-se automático.

Eis o que vamos cobrir: o que é realmente o Dataview, como instalá-lo, como adicionar os metadados que ele lê, os quatro tipos de consulta, como escolher e filtrar as suas fontes, consultas inline, dois dashboards completos para copiar e colar, e um checklist para solução de problemas quando uma consulta teima em não retornar nada. No final, você será capaz de criar os seus próprios dashboards — ou pular o DQL completamente e deixar que um template pronto faça isso por você.

O que é o Obsidian Dataview e por que ele é importante?

O Dataview é um índice em tempo real do seu vault combinado com uma linguagem de consulta que lê os metadados das suas notas e os exibe como tabelas, listas, painéis de tarefas ou calendários. Você não move nem duplica nenhum dado. Você descreve o que deseja — “todas as notas em Projects com a tag active, ordenadas por data de vencimento” — e o Dataview constrói a visualização, atualizando-a automaticamente conforme o seu vault muda.

Isso é fundamental porque os índices manuais ficam desatualizados no momento em que são criados. Uma nota manual de “Projetos Ativos” fica obsoleta assim que você conclui o projeto seguinte. Uma consulta do Dataview nunca fica. O benefício acumula-se à medida que o seu vault cresce: a mesma consulta de três linhas que mostra dois projetos hoje mostrará vinte no próximo ano, sem nenhum esforço adicional da sua parte.

Pense em cada nota como uma linha num banco de dados e cada propriedade como uma coluna. O Dataview permite fazer perguntas a esse banco de dados numa sintaxe simples e legível. Este é o complemento natural para bons hábitos de ligação — se você ainda está a desenvolvê-los, o nosso guia completo para conectar as suas notas combina perfeitamente com o que aprenderá aqui, porque quanto mais as suas notas se referenciarem, mais material o Dataview terá para trabalhar.

Como instalar e ativar o Dataview?

Você pode instalar o Dataview através do painel de Plugins da Comunidade no Obsidian em menos de um minuto. Eis a sequência exata:

1. Abra Definições → Plugins da comunidade.
2. Se vir o “Modo restrito” (Restricted mode) ativado, desative-o (isso permite a execução de plugins da comunidade).
3. Clique em Procurar (Browse) e pesquise por Dataview.
4. Clique em Instalar e depois em Ativar.

Assim que estiver ativado, o Dataview começa a indexar o seu vault em segundo plano. Num vault pequeno isso é instantâneo; num vault grande pode levar alguns segundos na primeira vez.

Em seguida, abra as definições do plugin e marque duas opções que desbloqueiam a sua capacidade total:

• Ativar Consultas Inline (Enable Inline Queries) — permite exibir um único valor no meio de uma frase (coberto mais adiante).
• Ativar Consultas JavaScript (Enable JavaScript Queries) — necessário apenas se pretender usar DataviewJS para lógica personalizada avançada. Deixe desativado se estiver a começar.

Dica: Você não precisa “reconstruir” nada manualmente. O Dataview reindexa automaticamente conforme você edita, cria e elimina notas. A única exceção é coberta na seção de solução de problemas perto do final.

Como adicionar metadados: Propriedades do Frontmatter vs Campos Inline?

O Dataview lê dois tipos de metadados: o frontmatter YAML (o Obsidian chama a estes de Propriedades) e campos inline escritos no corpo de uma nota. Ambos tornam-se colunas consultáveis; você escolhe com base em onde os dados se encaixam mais naturalmente.

O Frontmatter (Propriedades) fica no topo de uma nota entre duas linhas --- e é ideal para dados estruturados ao nível da nota:

---
status: active
due: 2026-07-15
priority: 1
tags: [project, client]
---

Os Campos inline permitem registar dados no meio da nota usando dois pontos duplos. Use chave:: valor na sua própria linha, ou [chave:: valor] para incorporar um campo numa frase:

Project kicked off today.
status:: in-progress
Budget is [budget:: 4500] for this quarter.

Os tipos de campo são inferidos automaticamente: texto, número, data (formato ISO como 2026-07-15), lista (tags: [a, b]) e link ([[Uma Nota]]). Além de tudo o que você adicionar, cada nota vem com campos file.* integrados que você pode consultar sem definir nada:

Campo integrado	O que retorna
file.name	O nome do arquivo da nota
file.link	Um link clicável para a nota
file.ctime / file.mtime	Hora de criação / última modificação
file.tags	Todas as tags na nota
file.inlinks / file.outlinks	Notas com links de entrada / saída
file.folder	O caminho da pasta

Esse campo file.inlinks é um superpoder silencioso — permite construir visualizações baseadas puramente em como as suas notas estão conectadas, e é por isso que a ligação deliberada vale a pena.

Quais são os quatro tipos de consulta: TABLE, LIST, TASK e CALENDAR?

O Dataview oferece quatro tipos de consulta e cada um produz uma forma de saída diferente. Você escreve-os dentro de um bloco de código rotulado como dataview.

LIST é o mais simples — uma lista de notas em formato de tópicos:

LIST
FROM "Projects"
WHERE status = "active"

TABLE é o cavalo de batalha do dia a dia, adicionando colunas para qualquer campo que você nomear:

TABLE status, due, file.mtime AS "Last Edited"
FROM "Projects"
SORT due ASC

TASK extrai itens individuais com caixas de seleção (- [ ]) das suas notas, agrupados pela nota onde residem — perfeito para uma visualização de tarefas em todo o vault:

TASK
WHERE !completed

CALENDAR projeta notas numa grelha mensal usando um campo de data escolhido, o que é útil para visualizar reuniões ou prazos:

CALENDAR due
FROM "Projects"

Recorra a LIST e TABLE para quase tudo, TASK quando quiser agregar caixas de seleção entre notas e CALENDAR quando uma visualização em grelha por datas contar a história melhor do que linhas. Se a gestão de tarefas for o seu objetivo principal, o nosso guia completo para gestão de tarefas no Obsidian mostra como estes tipos de consulta se encaixam num fluxo de trabalho real.

Como escolher as suas fontes com FROM?

A cláusula FROM diz ao Dataview quais notas considerar, e você pode segmentar pastas, tags ou links. Se acertar nisto, as suas consultas permanecerão rápidas e focadas.

• Por pasta: FROM "Projects" (coloque sempre o caminho entre aspas; use "Areas/Health" para subpastas).
• Por tag: FROM #active (sem aspas em tags).
• Por link de entrada: FROM [[Project Alpha]] encontra cada nota que aponta para essa nota.
• Por link de saída: FROM outgoing([[Project Alpha]]) encontra as notas para as quais o Alpha aponta.

Combine fontes com AND e OR, e exclua com um sinal de menos. Este é o padrão mais útil na prática — selecione uma pasta, filtre por tag e exclua os seus templates:

TABLE status, due
FROM "Projects" AND #active AND -"Templates"
SORT due ASC

Essa consulta lê tudo na pasta Projects com a tag #active, excluindo qualquer coisa na pasta Templates.

Nota: Restringir o escopo com FROM não é apenas organização — é um hábito de desempenho. Uma consulta que começa com FROM "Projects" analisa apenas essa pasta, enquanto uma consulta sem FROM analisa todo o seu vault a cada atualização.

Como filtrar, ordenar e agrupar resultados?

Assim que escolher a sua fonte, WHERE, SORT e GROUP BY moldam o resultado. Estas são as cláusulas que você ajustará com mais frequência.

WHERE filtra linhas usando comparações e funções:

• Comparações: WHERE priority >= 2, WHERE status = "active", WHERE due < date(today).
• Funções: contains(file.name, "2026"), length(tags) > 0 e matemática de datas como due <= date(today) + dur(7 days).

SORT ordena os resultados: SORT due ASC ou SORT file.mtime DESC. LIMIT restringe a quantidade: LIMIT 10.

GROUP BY agrupa resultados sob um valor compartilhado — agrupe tarefas por status, notas por pasta ou leituras por autor:

TABLE rows.file.link AS "Projects"
FROM "Projects"
GROUP BY status

Quando um campo contém uma lista (como múltiplas tags ou autores), use FLATTEN para a desdobrar numa linha por valor antes de agrupar — caso contrário, a lista será tratada como um único bloco. Eis uma receita para copiar e colar de “notas modificadas recentemente” que combina várias destas cláusulas:

TABLE file.mtime AS "Modified"
FROM ""
SORT file.mtime DESC
LIMIT 10

E uma consulta de limpeza de “notas sem tags”, útil para manter um vault organizado:

LIST
WHERE length(file.tags) = 0

Como escrever DQL inline e quando deve usar DataviewJS?

O DQL inline permite inserir um único valor calculado diretamente numa frase, em vez de renderizar um bloco inteiro. Escreve-se com o prefixo de crase e sinal de igual. Por exemplo, = this.due exibe a data de vencimento da nota atual inline, e = dv.current().file.mtime exibe quando esta nota foi editada pela última vez — ambos atualizam em tempo real.

Isto é ideal em templates e notas diárias: um cabeçalho que diz “Última revisão: = this.reviewed” mantém-se preciso sem que precise de lhe tocar. As consultas inline devem ser ativadas nas definições (você ativou isso durante a instalação).

O DataviewJS é o nível avançado. Ele substitui a sintaxe legível do DQL por JavaScript e pela API dv.*, oferecendo loops, condicionais e lógica personalizada arbitrária — por exemplo, dv.pages("#book").where(p => p.rating > 4). A compensação é uma curva de aprendizagem mais íngreme e o interruptor de Consultas JavaScript. Trate-o como o passo seguinte depois de estar confortável com o DQL, não como o seu ponto de partida. A vasta maioria dos dashboards nunca precisa dele.

Dica: Se der por si a recorrer ao DataviewJS para fazer algo simples, geralmente existe uma forma direta em DQL simples. Reserve o JavaScript para renderizações verdadeiramente personalizadas.

Como criar dashboards reais para tarefas e projetos?

Um dashboard é simplesmente uma nota contendo várias consultas que juntas respondem a: “O que exige a minha atenção?” Eis dois exemplos completos para copiar e colar que pode colocar numa nota e editar.

Passo a passo 1 — um dashboard de tarefas. Isto traz à tona todas as tarefas abertas no seu vault, isola as em atraso e agrupa-as por arquivo para que possa ver o que cada projeto exige:

TASK
WHERE !completed AND due AND due < date(today)
GROUP BY file.link

Substitua due < date(today) por due <= date(today) + dur(7 days) para ver tudo o que vence esta semana. Para uma gestão mais rica de datas de vencimento e recorrência, combine o Dataview com o plugin Tasks: o Tasks gerencia o agendamento, recorrência e a interface elegante de caixas de seleção, enquanto o Dataview agrega e relata através das notas. O nosso guia definitivo sobre o plugin Tasks cobre essa combinação em detalhe, e encaixa perfeitamente numa configuração GTD se esse for o seu método.

Passo a passo 2 — um dashboard de projetos. Uma tabela única de projetos ativos com o status, a próxima ação e quando foi modificado pela última vez:

TABLE status AS "Status", next_action AS "Next Action", file.mtime AS "Last Modified"
FROM "Projects" AND -"Templates"
WHERE status != "done"
SORT file.mtime DESC

Construir estes dashboards do zero é uma excelente forma de aprender — mas se preferir tê-los prontos a usar, é exatamente aqui que um template pronto brilha. O Obsibrain vem com dashboards alimentados pelo Dataview para tarefas, projetos e revisões diárias/semanais pré-configurados de fábrica, para que obtenha os benefícios sem escrever uma única linha de DQL.

Quais são os erros comuns e armadilhas de desempenho?

A maioria das consultas Dataview “com defeito” falha pelas mesmas razões. Percorra este checklist antes de presumir que a culpa é do plugin.

• Sintaxe de campo inline: use dois pontos duplos (status:: active), e não simples. Um único dois pontos não faz nada fora do frontmatter.
• Sensibilidade a maiúsculas/minúsculas: Status e status são campos diferentes, e "Active" não corresponderá a "active" num WHERE. Mantenha a consistência.
• Coloque caminhos de pasta entre aspas: FROM "Projects" funciona; FROM Projects é lido como uma fonte do tipo tag e falha.
• Campos ausentes retornam null: uma consulta que filtra por priority omite silenciosamente cada nota a que falte o campo priority. É por isso que muitas vezes os resultados parecem incompletos em vez de vazios.
• Não misture tipos de campo: se due for uma data em algumas notas e texto simples em outras, as comparações e a ordenação falham. Mantenha um campo com um único tipo em todo o vault.

Para desempenho em vaults grandes, a regra é dar ao Dataview menos elementos para analisar:

1. Restrinja cada consulta com FROM "Pasta" ou FROM #tag em vez de FROM "".
2. Adicione um LIMIT a listas longas que você não lê por completo.
3. Evite colocar código DataviewJS pesado em notas que você abre constantemente.
4. Se os resultados parecerem desatualizados após edições, desative e reative o plugin nas definições (ou reinicie o Obsidian) para forçar uma reindexação.

Nota: Uma consulta que não retorna nada é muito mais frequentemente um problema de metadatos (um campo ausente, um nome de pasta com erro de digitação, uma diferença de maiúsculas/minúsculas) do que um erro do Dataview. Comece pelo campo, não pela sintaxe.

Dataview vs Obsidian Bases: Qual deve usar em 2026?

O Obsidian lançou o Bases como um recurso nativo em 2025, e ele sobrepõe-se ao Dataview o suficiente para confundir os novos utilizadores. O Bases é uma visualização de banco de dados no estilo folha de cálculo sem código: você cria tabelas e filtros através de uma interface gráfica, está embutido no Obsidian (sem necessidade de plugin) e funciona perfeitamente em dispositivos móveis. O Dataview é uma linguagem de consulta baseada em texto: mais expressiva, mais portátil em markdown simples e muito superior para extrair tarefas e calcular valores derivados.

Use o Bases quando quiser uma tabela visual rápida sem sintaxe para aprender e se utiliza maioritariamente dispositivos móveis. Recorra ao Dataview quando precisar de consultas TASK, valores inline em texto, filtragem complexa ou dashboards que viajem como texto simples. Muitos utilizadores avançados usam ambos — Bases para bancos de dados navegáveis, Dataview para relatórios e agregação de tarefas. Nenhum deles vai desaparecer, por isso escolha com base no seu caso de uso.

Perguntas Frequentes

O plugin Dataview é gratuito e continua a ser mantido e seguro em 2026? Sim. O Dataview é gratuito, de código aberto e um dos plugins da comunidade mais instalados no ecossistema Obsidian. É estável e amplamente utilizado. Dito isto, é um plugin da comunidade (não nativo), pelo que para configurações críticas é sensato manter os seus dados em markdown simples — o que o Dataview faz por design, pois apenas lê as suas notas e nunca as altera.

Qual é a diferença entre o Dataview e o plugin Tasks — preciso de ambos? Eles resolvem problemas diferentes e complementam-se bem. O plugin Tasks gerencia tarefas individuais: datas de vencimento, recorrência, agendamento e uma interface elegante de caixas de seleção. O Dataview agrega e relata — criando tabelas e listas em todo o seu vault. Para uma gestão séria de tarefas, a maioria das pessoas executa ambos: o Tasks cuida do ciclo de vida das tarefas enquanto o Dataview alimenta os dashboards.

Por que a minha consulta do Dataview não funciona ou não mostra resultados? Noventa por cento das vezes trata-se de metadatos, não da consulta. Verifique se há dois pontos simples em vez de duplos em campos inline, divergência de maiúsculas/minúsculas (Status vs status), um caminho de pasta sem aspas ou um campo que simplesmente não existe nas notas esperadas. Uma cláusula WHERE que filtra por um campo ausente remove silenciosamente essas notas. Corrija primeiro o campo e depois a sintaxis.

O Dataview torna o Obsidian lento em vaults grandes e as consultas funcionam no telemóvel e no Obsidian Publish? Em vaults muito grandes, consultas sem escopo podem apresentar lentidão — resolva isso adicionando uma pasta/tag FROM e um LIMIT. As consultas funcionam em dispositivos móveis (embora as mais pesadas sejam mais lentas em smartphones) e sincronizam-se entre dispositivos como texto simples, uma vez que residem nas suas notas. Tenha em atenção que o Dataview não é renderizado no Obsidian Publish, portanto as páginas publicadas mostrarão a consulta em bruto e não a tabela.

Comece pequeno e deixe crescer

Você não precisa dominar todas as cláusulas esta semana. Adicione uma propriedade status a algumas notas de projeto, cole a tabela de modificados recentemente e veja-a ser preenchida — essa vitória única é geralmente suficiente para fazer o sistema fazer sentido. A partir daí, crie um dashboard de tarefas, depois uma visualização de projetos, depois uma revisão semanal, adicionando uma consulta de cada vez à medida que surgir uma necessidade real.

E se você adora os resultados mas não a manutenção, não precisa de construir nada disso sozinho. O Obsibrain vem com estes dashboards Dataview pré-configurados — tarefas, projetos e revisões periódicas prontos no primeiro dia — para que possa dedicar o seu tempo a pensar em vez de escrever consultas. Quer opte por construir ou por usar uma solução pronta, o objetivo é o mesmo: um vault que se organiza sozinho enquanto você se concentra no trabalho que realmente importa.