Guia rápido de formatos de tarefas do Obsidian
O Obsidian não tem sintaxe de tarefas além do checkbox. Os plugins acrescentam o resto, e fazem isso de quatro maneiras diferentes. Esta página lista todos os campos de cada uma, com os caracteres exatos para digitar.
Conferido com Obsidian Tasks 8.6, Task Genius 9.13, TaskNotes 4.14 e a documentação do Dataview em outubro de 2026. A documentação de cada plugin está linkada no final e vale mais que esta página se houver divergência.
Imprimir esta página gera uma referência compacta, sem a navegação do site.
Anatomia de uma linha de tarefa
Uma tarefa é um item de lista com um checkbox. Depois da descrição vêm os campos, cada um um símbolo seguido de um valor. O Obsidian Tasks lê a linha da direita para a esquerda, então os campos ficam no fim, depois do texto, e qualquer texto não reconhecido entre dois campos interrompe a leitura naquele ponto.
A mesma tarefa em cada formato inline:
- [ ] Pay rent ⏫ 🔁 every month ➕ 2026-01-02 ⏳ 2026-01-14 📅 2026-01-15- [ ] Pay rent [priority:: high] [repeat:: every month] [created:: 2026-01-02] [scheduled:: 2026-01-14] [due:: 2026-01-15]- [ ] Pay rent #project/Home @bank ⏫ 📅 2026-01-15 09:00 [repeat:: every month]Um arquivo de tarefa guarda os mesmos dados no frontmatter YAML. Veja a seção de arquivos de tarefa abaixo.
Campos, lado a lado
As datas são sempre YYYY-MM-DD. A coluna do Dataview usa colchetes. O Obsidian Tasks e o Dataview também leem parênteses, (due:: 2026-01-15); o Task Genius lê só colchetes. O Task Genius lê o emoji e a forma com colchetes, então a coluna dele lista apenas o que ele acrescenta ou escreve de outro jeito.
Role para o lado em telas estreitas.
| Campo | Emoji do Obsidian Tasks | Estilo Dataview | Task Genius |
|---|---|---|---|
| Data de vencimento O prazo final. O Obsidian Tasks também lê 📆 e 🗓 como vencimento. | 📅 2026-01-15 | [due:: 2026-01-15] | Igual aos outros dois |
| Data agendada O dia em que você planeja trabalhar nela. O Obsidian Tasks também lê ⌛. | ⏳ 2026-01-14 | [scheduled:: 2026-01-14] | Igual aos outros dois |
| Data de início A tarefa não é acionável antes desse dia. | 🛫 2026-01-10 | [start:: 2026-01-10] | Igual aos outros dois |
| Data de criação Adicionada quando a tarefa é criada, se o plugin estiver configurado para isso. | ➕ 2026-01-02 | [created:: 2026-01-02] | Igual aos outros dois |
| Data de conclusão Adicionada quando você marca a tarefa. No estilo Dataview a chave é completion, não done. | ✅ 2026-01-15 | [completion:: 2026-01-15] | Igual aos outros dois |
| Data de cancelamento Acompanha um status de cancelada, como [-]. | ❌ 2026-01-15 | [cancelled:: 2026-01-15] | Igual aos outros dois |
| Prioridade Cinco níveis, da mais alta à mais baixa. A prioridade normal não se escreve. | 🔺 highest ⏫ high 🔼 medium 🔽 low ⏬ lowest | [priority:: highest] [priority:: high] [priority:: medium] [priority:: low] [priority:: lowest] | [#A] |
| Recorrência O Obsidian Tasks e o estilo Dataview usam palavras simples que começam com every. O Task Genius lê essas e as regras do iCalendar. Veja a seção de recorrência. | 🔁 every week on Sunday when done | [repeat:: every week on Sunday when done] | [recurrence:: FREQ=WEEKLY;BYDAY=SU] |
| Ao concluir O que fazer com a tarefa quando ela é concluída. O Obsidian Tasks aceita keep e delete. | 🏁 delete 🏁 keep | [onCompletion:: delete] | Igual aos outros dois |
| ID da tarefa Só letras, dígitos, hífen e sublinhado. | 🆔 abc123 | [id:: abc123] | Igual aos outros dois |
| Depende de Um ou mais IDs de tarefa, separados por vírgulas. | ⛔ abc123,def456 | [dependsOn:: abc123,def456] | Igual aos outros dois |
| Hora do dia O Obsidian Tasks não tem campo de hora. O Task Genius lê uma hora depois da data. | Não disponível | Não disponível | 📅 2026-01-15 14:30 [due:: 2026-01-15 14:30] |
| Projeto e contexto O Obsidian Tasks não tem campo de projeto nem de contexto; use tags nele. O Task Genius lê esses campos. | Não disponível | Não disponível | #project/Website @phone [project:: Website] [context:: phone] |
Ordem em que o Obsidian Tasks escreve os campos
Quando o Obsidian Tasks escreve uma linha, ele coloca primeiro o ID, as dependências, a prioridade, a recorrência e a ação ao concluir, depois as datas de criação, início, agendada e vencimento, e por fim as de cancelamento e conclusão. Escrever à mão em outra ordem funciona, desde que todos os campos fiquem no fim da linha.
Caracteres de status
O caractere entre os colchetes é o status. Só o espaço e o x são universais. Todo o resto é uma convenção à qual um plugin, um tema ou uma coleção de status dá significado.
| Caractere | Significado usual | Quem entende |
|---|---|---|
[ ] | A fazer | Tudo, inclusive o próprio Obsidian |
[x] | Concluída (x ou X) | Tudo, inclusive o próprio Obsidian |
[/] | Em andamento | Task Genius por padrão, Obsidian Tasks como status personalizado |
[-] | Cancelada ou abandonada | Task Genius por padrão, Obsidian Tasks como status personalizado |
[>] | Em andamento (Task Genius) ou encaminhada | Task Genius por padrão, uma convenção em outros lugares |
[<] | Agendada | Uma convenção de coleções de status e temas, não um padrão do Task Genius; um status personalizado no Obsidian Tasks |
[?] | Planejada | Task Genius por padrão, em outros lugares costuma ser lido como pergunta |
[!] | Importante | Uma convenção de coleções de status e temas, não um padrão do Task Genius; um status personalizado no Obsidian Tasks |
No Obsidian Tasks, um caractere que você não configurou aparece como status Unknown. Adicione-o nos ajustes de Custom Statuses do plugin ou carregue uma coleção de status pronta.
O Task Genius só trata x e X como concluídas. Os arquivos do TaskNotes não usam caracteres de checkbox; eles têm uma propriedade status, explicada mais abaixo.
Recorrência
A recorrência é onde os formatos mais diferem. A mesma tarefa semanal, escrita de quatro maneiras:
- [ ] Water plants 🔁 every week on Sunday when done 📅 2026-01-18- [ ] Water plants [repeat:: every week on Sunday when done] [due:: 2026-01-18]- [ ] Water plants [recurrence:: FREQ=WEEKLY;BYDAY=SU] [due:: 2026-01-18]recurrence: "DTSTART:20260118;FREQ=WEEKLY;BYDAY=SU"
recurrence_anchor: completionRegras que o Obsidian Tasks entende
Toda regra começa com a palavra every. Acrescente when done para contar a partir do dia em que você conclui, em vez da data original.
every 3 days
every 10 days when done
every weekday
every week on Sunday
every week on Tuesday, Friday
every 2 weeks
every 3 weeks on Friday
every 2 months
every month on the 1st
every month on the last
every month on the last Friday
every month on the 2nd last Friday
every January on the 15th
every April and December on the 1st and 24th
every yearComo a conclusão se comporta
- Obsidian Tasks: marcar uma tarefa recorrente conclui aquela linha e adiciona uma linha nova, por padrão acima dela, com as datas avançadas. Um ajuste coloca a linha nova abaixo.
- Obsidian Tasks: uma tarefa recorrente precisa de pelo menos uma data de vencimento, agendada ou de início. Sem nenhuma, a regra não tem o que mover.
- Obsidian Tasks: numa regra mensal, uma data que não existe (dia 31 em abril) recua para o último dia válido. Já uma regra que cita o dia 31 pula os meses que não o têm.
- Obsidian Tasks: a linha nova descarta o ID e o campo de dependências, para que uma dependência não bloqueie para sempre.
- TaskNotes: o arquivo continua sendo uma única tarefa. As datas concluídas e puladas vão para complete_instances e skipped_instances, e o agendamento avança.
- Task Genius: a próxima data vem de uma regra do iCalendar ou de uma frase simples como every 2 weeks. Frases mais ricas do Obsidian Tasks, como every weekday ou the last Friday of the month, não são lidas do mesmo jeito, então teste algumas antes de confiar nelas.
- Não coloque tarefas recorrentes em notas diárias. Uma linha recorrente numa nota diária é copiada para a nota de cada dia.
Arquivos de tarefa: frontmatter do TaskNotes
O TaskNotes guarda uma tarefa por nota. Os dados ficam no frontmatter YAML e o corpo é texto livre. Um arquivo conta como tarefa quando tem a tag ou a propriedade que você definiu nos ajustes do plugin, por padrão a tag task.
---
tags:
- task
title: Review quarterly report
status: in-progress
priority: high
due: 2026-01-15
scheduled: 2026-01-14
contexts:
- office
projects:
- "[[Q1 Planning]]"
timeEstimate: 90
recurrence: "DTSTART:20260115;FREQ=MONTHLY;BYMONTHDAY=15"
recurrence_anchor: scheduled
---
Notes, links and a checklist go in the body.Propriedades
| Propriedade | Exemplo | Significado |
|---|---|---|
| title | | O nome da tarefa. |
| status | | Um valor da sua lista de status. Os padrões são open, in-progress e done. |
| priority | | Um valor da sua lista de prioridades. Os padrões são low, normal e high. |
| due | | Prazo final, como data ou como data e hora. |
| scheduled | | O dia em que você planeja trabalhar nela. |
| completedDate | | Definida quando a tarefa é concluída. |
| dateCreated | | Momento de criação como timestamp ISO. |
| dateModified | | Última alteração como timestamp ISO. |
| tags | | Uma lista YAML, escrita sem o jogo da velha. |
| contexts | | Uma lista YAML de lugares ou modos. |
| projects | | Uma lista YAML de links para notas de projeto. |
| timeEstimate | | Um número de minutos. |
| recurrence | | Uma regra do iCalendar. DTSTART define a data âncora. |
| recurrence_anchor | | scheduled ou completion: de onde a próxima data é contada. |
| complete_instances | | Datas das ocorrências concluídas de uma tarefa recorrente. |
| skipped_instances | | Datas das ocorrências puladas. |
| blockedBy | | Tarefas que precisam terminar antes, como objetos com um uid, um tipo de relação e um intervalo opcional. |
Os nomes das propriedades são ajustes. Se você renomear due para deadline no plugin, o arquivo precisa usar deadline.
Listas precisam ser listas, mesmo com um só item. Um valor simples onde se espera uma lista é o motivo mais comum de um arquivo de tarefa não aparecer em uma visualização.
Armadilhas que custam uma noite
- O Obsidian Tasks lê e escreve um formato por vez. Se o ajuste dele for Dataview, ele deixa de ler os próprios emoji até você trocar de volta.
- O Dataview exige dois-pontos duplo, [due:: 2026-01-15]. Dois-pontos simples não é um campo.
- Os colchetes precisam combinar. [due:: 2026-01-15) não é lido.
- No estilo Dataview, as chaves do Obsidian Tasks diferenciam maiúsculas de minúsculas: repeat, dependsOn e onCompletion funcionam, Repeat e dependson não. O Task Genius compara as chaves sem diferenciar maiúsculas.
- A chave da data de conclusão é completion. [done:: 2026-01-15] é só um campo desconhecido.
- O Dataview documenta 🗓️ como atalho de vencimento, enquanto o Obsidian Tasks escreve 📅. Se você consulta datas em emoji com o Dataview, teste sua própria versão primeiro. Campos entre colchetes evitam a dúvida.
- Texto colado pode trazer espaços não separáveis ou um seletor de variação depois de um emoji. O Obsidian Tasks não lê isso, e a linha parece normal na tela.
- O Dataview tem atalhos só para cinco datas. Prioridade e recorrência não têm atalho e exigem a forma com colchetes.
- Um filtro global como #task no Obsidian Tasks faz ele ignorar todo checkbox sem essa tag. Tarefas que somem das consultas muitas vezes são isso.
- Linhas de checkbox dentro de um bloco de código cercado não são tarefas em nenhum desses plugins.
Fontes de verdade
Os plugins mudam. Quando algo aqui parecer errado para a sua versão, confie nestas fontes em vez desta página.
- Obsidian Tasks: Tasks Emoji Format (formato emoji)
- Obsidian Tasks: Dataview Format
- Obsidian Tasks: Recurring Tasks (tarefas recorrentes)
- Obsidian Tasks: Statuses
- Dataview: Metadata on Tasks and Lists
- Dataview: Adding Metadata (inline fields)
- Documentação do Task Genius
- Task Genius no GitHub
- Documentação do TaskNotes
- TaskNotes: Property Types Reference
Usando no celular
O TaskForge, um app independente para iPhone, iPad, Mac, Android e Windows, lê as formas emoji, Dataview e Task Genius acima e arquivos de tarefa no estilo TaskNotes da mesma pasta. Não é um plugin do Obsidian e não tem vínculo com o Obsidian. Você não precisa dele para usar nada desta página.
Perguntas frequentes
Qual é a sintaxe do Obsidian Tasks para uma data de vencimento?
Digite o emoji de calendário, um espaço e a data: - [ ] Pay rent 📅 2026-01-15. No estilo Dataview é [due:: 2026-01-15]. Os dois usam YYYY-MM-DD.
Quais são os emoji de prioridade do Obsidian Tasks?
🔺 máxima, ⏫ alta, 🔼 média, 🔽 baixa e ⏬ mínima. A prioridade normal não tem símbolo. No estilo Dataview o campo é priority e os valores são highest, high, medium, low e lowest.
Posso usar campos inline do Dataview em vez de emoji no Obsidian Tasks?
Sim. Defina o formato de tarefa nos ajustes do Obsidian Tasks como Dataview e ele passa a ler e escrever campos no estilo [due:: 2026-01-15]. Ele lê só o formato escolhido, então as linhas em emoji existentes precisam ser convertidas. Veja a página de conversão para receitas.
Como escrevo uma tarefa recorrente no Obsidian?
Com o Obsidian Tasks, acrescente 🔁 e uma regra que comece com every, mais pelo menos uma data: - [ ] Water plants 🔁 every week on Sunday 📅 2026-01-18. Com o TaskNotes, defina a propriedade recurrence com uma regra do iCalendar, como FREQ=WEEKLY;BYDAY=SU.
Que caracteres de status uma tarefa do Obsidian pode ter?
Qualquer caractere isolado cabe entre os colchetes. O espaço e o x são padrão. Caracteres como /, - e > só significam algo depois que um plugin ou tema os define.
O Task Genius usa a mesma sintaxe do Obsidian Tasks?
Ele lê os mesmos emoji e a forma de colchetes do Dataview na mesma linha, então um cofre escrito para o Obsidian Tasks funciona. Acrescenta uma hora depois da data, campos de projeto e contexto e regras de recorrência do iCalendar. Qual formato ele escreve é um ajuste.