Dataview no Obsidian: consultas, tabelas e tarefas

O Dataview é o plugin da comunidade que transforma um vault do Obsidian em algo que dá para consultar. Você continua escrevendo notas normais, coloca algumas propriedades no topo de cada uma, e o Dataview monta listas e tabelas vivas com elas: cada projeto que vence este mês, cada livro que você está lendo, cada cliente com quem você não fala há dois meses. Nada é copiado ou exportado, então as tabelas mudam assim que uma nota muda. Este guia cobre as consultas que você vai usar de verdade, com exemplos tirados dos painéis dos nossos próprios vaults.

O que o plugin Dataview do Obsidian faz

O Dataview lê três tipos de dados das suas notas. As propriedades são o bloco YAML no topo da nota, entre duas linhas de três hifens. Os campos em linha são escritos no texto como chave:: valor, ou entre colchetes na linha de uma tarefa. Os campos implícitos são os que o Obsidian já conhece, como file.name, file.ctime, file.tags ou file.link. Uma consulta é um bloco de código com a linguagem dataview, que no modo de leitura aparece como lista, tabela, lista de tarefas ou calendário. Uma nota com propriedades fica assim:

---
status: ativo
due: 2026-11-27
owner: Lina
---
# Redesign do site

As chaves (status, due, owner) ficam em inglês e sem acento, mesmo com os valores em português. O Dataview aceita chaves em português, mas um acento ou cedilha, como em situação, precisa ser digitado igualzinho em toda consulta, e modelos baixados de outros lugares quase sempre usam chaves em inglês. É a convenção de todos os nossos vaults.

Instale o Dataview e escreva sua primeira consulta

Abra Configurações, Plugins não oficiais, desative o modo restrito se ele ainda estiver ligado, clique em Procurar e busque Dataview. Instale, ative e pronto: não há nada para configurar antes da primeira consulta. Crie uma nota, adicione um bloco de código com a linguagem dataview e comece pela consulta mais simples, uma lista de todas as notas de uma pasta:

```dataview
LIST
FROM "Projetos"
```

No modo de leitura, o bloco vira uma lista de links. Troque LIST por TABLE, diga quais propriedades quer como colunas e você tem um controle de projetos:

```dataview
TABLE status, due, owner
FROM "Projetos"
WHERE status = "ativo"
SORT due ASC
```

Sintaxe das consultas do Dataview: FROM, WHERE, SORT e GROUP BY

Toda consulta começa pelo tipo, LIST, TABLE, TASK ou CALENDAR, seguido de comandos opcionais que rodam em ordem. FROM escolhe a origem: uma pasta entre aspas, uma tag como #livro ou [[]] para as notas que apontam para a atual. As origens se combinam com AND, OR e um sinal de menos na frente para excluir. WHERE mantém só as linhas que batem com a condição, por exemplo WHERE status = "ativo" ou WHERE due <= date(today). SORT ordena por um ou mais campos, em ordem crescente ou decrescente, e LIMIT corta o resultado em um número de linhas. As palavras da consulta ficam em inglês, mesmo que pastas e valores estejam em português.

O GROUP BY é o que deixa as tabelas úteis. Ele junta as linhas com o mesmo valor em uma linha por grupo, e as notas originais vão para uma lista chamada rows, que você conta com length(rows) ou soma com sum(rows.value). O valor do grupo se chama key. Esta consulta conta os projetos por status:

```dataview
TABLE rows.file.link AS "Notes", length(rows) AS "Count"
FROM "Projetos"
GROUP BY status
```

Dois detalhes confundem quase todo mundo. Um nome de propriedade com hífen seria lido como uma subtração, então precisa ser escrito como row["date-started"], que é como o nosso vault de anotações de livros lê as datas de leitura. E WITHOUT ID depois de TABLE esconde a primeira coluna automática com o nome do arquivo, quando você quer escolher a primeira coluna.

Tarefas com Dataview no Obsidian: consultar as caixas de todo o vault

Uma consulta TASK devolve as próprias caixas de seleção, não as notas, e dá para marcá-las direto nos resultados. O Dataview lê uma data de entrega escrita como campo em linha na tarefa, e também entende a data 📅 do plugin Tasks:

- [ ] Enviar o orçamento revisado [due:: 2026-10-28]

```dataview
TASK
FROM "Projetos"
WHERE !completed AND due AND due <= date(today)
GROUP BY file.link
```

Se as tarefas são o centro do seu sistema, o plugin Tasks tem uma sintaxe mais completa e recorrência, e o nosso guia de tarefas no Obsidian compara os dois. O Dataview é a melhor escolha quando as tarefas são só uma parte de um painel que também mostra notas e propriedades.

Exemplos de tabelas do Dataview nos nossos vaults

Cada consulta desta seção roda em um vault que você pode baixar: abra e veja o resultado com dados reais. O vault de gestão de projetos lista os projetos ativos por data de entrega. O vault de campanha de D&D agrupa cada NPC por local no escudo do mestre com GROUP BY location. O vault de anotações de livros mostra o que você está lendo e o que terminou, com a nota de cada um. O vault para estudantes lista as entregas de hoje em diante com WHERE due AND due >= date(today). Nosso modelo de CRM para Obsidian vai mais longe: acompanhamentos da semana, valor do funil por etapa e contatos com quem você não fala há 60 dias, com date(today) - last_contact > dur(60 days).

Dataview ou Bases no Obsidian

O Bases é um plugin principal que chegou ao Obsidian em 2025. Ele também transforma propriedades em tabelas, mas a visualização é montada com cliques em vez de uma consulta escrita, e os valores podem ser editados na própria tabela. Uma base fica salva em um arquivo .base, cuja definição é YAML legível:

filters:
  and:
    - file.inFolder("Projetos")
views:
  - type: table
    name: All
    groupBy:
      property: status
      direction: ASC

Use o Bases quando quiser uma visualização editável, parecida com planilha, das notas e suas propriedades, sem instalar nada. Fique com o Dataview para o que o Bases não faz: consultas no meio de uma nota, consultas de tarefas, links entre notas como origem, contas com datas como "sem mexer há 60 dias" e consultas em JavaScript com DataviewJS. Muitos vaults usam os dois, e o vault de CRM traz um funil em Bases ao lado do painel em Dataview para você comparar com os mesmos dados.

Por que uma consulta do Dataview não mostra resultados

Quase toda tabela vazia tem uma destas quatro causas, e duas são bem brasileiras. A primeira é a data. due: 28/10/2026 fica guardado como texto, e a comparação com date(today) nunca bate: escreva sempre AAAA-MM-DD. A segunda são os centavos. valor: 1.500,50, com ponto de milhar e vírgula, também é texto para o Dataview, e o sum() ignora. Escreva os valores como 1500.50 ou sem centavos. As outras duas valem para todo mundo: a pasta do FROM não confere com o caminho real, que diferencia maiúsculas e precisa ser completo para subpastas, ou você ainda está no modo de edição, onde a consulta aparece como código. Para as tabelas mostrarem a data como 28/10/2026, coloque dd/MM/yyyy no formato de data das configurações do Dataview. Esse campo usa os códigos do Luxon, com yyyy minúsculo, e não os dos modelos do Obsidian.