Integração

3 de novembro de 2025

Guia de Integração TaskNotes: Uma Tarefa Por Arquivo com Frontmatter YAML

Descubra como o TaskForge suporta o formato TaskNotes para Obsidian, permitindo gerenciar tarefas com uma tarefa por arquivo usando frontmatter YAML. Perfeito para documentação detalhada de tarefas, metadados ricos e fluxos de trabalho estruturados de anotações.

Integração TaskForge TaskNotes no macOS mostrando uma tarefa por arquivo com frontmatter YAML

Grátis - iOS e Mac

Grátis - Android

Ver Todos os Recursos

O Que é o Formato TaskNotes?

TaskNotes é um formato de gerenciamento de tarefas que armazena uma tarefa por arquivo usando frontmatter YAML para metadados. Diferente de tarefas inline dispersas por suas anotações, o TaskNotes dá a cada tarefa seu próprio arquivo dedicado com propriedades estruturadas e muito espaço para documentação detalhada.

Uma Tarefa Por Arquivo

Cada tarefa fica em seu próprio arquivo markdown, oferecendo espaço ilimitado para anotações, anexos e documentação.

Frontmatter YAML

Armazene metadados de tarefas em frontmatter YAML estruturado para status, prioridade, datas, tags e propriedades personalizadas.

Identificação Flexível

Identifique TaskNotes por tag ou propriedade personalizada. Escolha o método que melhor se adapta ao seu fluxo de trabalho.

Pastas Configuráveis

Defina uma pasta padrão para novos TaskNotes e organize-os da maneira que funcione para a estrutura do seu cofre.

Exemplo de Arquivo TaskNotes

Veja como é um arquivo TaskNotes típico no seu cofre Obsidian:

---
status: in-progress
priority: high
due: 2025-10-15
tags:
  - work
  - project-alpha
created: 2025-10-01
---

# Review PR #123

Review the new authentication system PR and provide feedback on:

- [ ] Code quality and patterns
- [ ] Test coverage
- [ ] Documentation completeness
- [ ] Security considerations

## Notes

- Need to verify the new token refresh logic
- Check that rate limiting is properly implemented
- Test with various user permission levels

## Links

- [[Authentication Design Doc]]
- [[Security Guidelines]]

Propriedades Suportadas

Status

Estado de conclusão da tarefa: todo, in-progress, on-hold, planned ou done

status: in-progress

Prioridade

Importância da tarefa: highest, high, medium, low ou lowest

priority: high

Datas

Datas de vencimento, datas agendadas, datas de início e datas de conclusão

due: 2025-10-15 scheduled: 2025-10-10 start: 2025-10-01

Recorrência

Configure tarefas recorrentes com intervalos flexíveis

recurrence: every week

Configurando TaskNotes

1

Enable Arquivos de Tarefas

Open Configurações > Tipos de Tarefas, toggle 'Arquivos de Tarefas' on, then tap 'Configurações de Arquivos de Tarefas' to configure identification, default folder, and field mapping.
2

Escolha o Método de Identificação

Selecione como o TaskForge deve identificar arquivos TaskNotes: por uma tag específica (ex: #task) ou por uma propriedade personalizada (ex: type: task).
3

Defina a Pasta Padrão

Escolha uma pasta padrão onde novos TaskNotes devem ser criados. Isso ajuda a manter seu cofre organizado.
4

Escolha o Formato Padrão

Decida se novas tarefas devem ser criadas como TaskNotes ou tarefas inline por padrão. Você sempre pode sobrescrever isso por lista personalizada.
5

Personalize o Mapeamento de Campos (Opcional)

Avançado: Personalize os nomes das propriedades YAML se você usar nomes de campos diferentes no seu cofre.

TaskNotes vs. Tarefas Inline

Use TaskNotes Quando:

Você precisa de documentação detalhada de tarefas
Tarefas exigem múltiplas anotações e anexos
Você prefere metadados estruturados
Tarefas são projetos complexos
Você quer arquivos de tarefas pesquisáveis

Use Tarefas Inline Quando:

Tarefas são itens de ação simples
Tarefas pertencem a anotações de reunião
Você prefere tarefas incorporadas no contexto
Captura rápida é prioridade
Você usa o plugin Obsidian Tasks

Boas notícias: Você não precisa escolher! O TaskForge suporta ambos os formatos lado a lado. Use TaskNotes para grandes projetos e tarefas inline para itens de ação rápidos - tudo em uma lista de tarefas unificada.

Que funcionalidades avancadas do TaskNotes estao disponiveis?

Para alem do basico da gestao de uma tarefa por ficheiro, o TaskNotes oferece varias funcionalidades avancadas que lhe permitem adaptar o sistema ao seu fluxo de trabalho exato. Estas opcoes sao especialmente uteis se ja tem uma estrutura de vault estabelecida ou convencoes especificas para organizar as suas notas.

Mapeamento de campos personalizado

Se o seu vault ja usa nomes de propriedades YAML diferentes, nao precisa de os alterar. O TaskForge permite-lhe remapear os nomes de campos predefinidos para corresponder aos seus. Por exemplo, se usa 'state' em vez de 'status' ou 'importance' em vez de 'priority', pode configurar o TaskForge para ler e escrever esses campos diretamente.

Formatos de nomes de ficheiro personalizados

Controle exatamente como os novos ficheiros TaskNotes sao nomeados usando variaveis como {title}, {date} e {priority}. Por exemplo, pode definir o formato como '{date}-{title}' para que cada ficheiro de tarefa comece com a sua data de criacao, facilitando a ordenacao cronologica dos ficheiros no explorador de ficheiros do Obsidian.

Modelos de corpo

Defina um modelo de corpo markdown predefinido que e inserido em cada novo ficheiro TaskNotes. Se quer sempre uma seccao de Notas, uma seccao de Lista de Verificacao e uma seccao de Ligacoes nos seus ficheiros de tarefas, configure um modelo uma vez e cada nova tarefa comeca com essa estrutura.

Projetos e contextos

O TaskNotes suporta anotacoes de projeto e contexto usando a sintaxe +NomeProjeto e @contexto. Marque uma tarefa com +RedesignWebsite para liga-la a um projeto especifico, ou @escritorio para indicar onde o trabalho deve ser feito. Estas anotacoes funcionam em conjunto com as tags regulares, dando-lhe uma forma mais rica de categorizar e filtrar tarefas no seu vault.

Como migrar de tarefas inline para TaskNotes?

Se tem usado tarefas inline e quer comecar a tirar partido do TaskNotes, a boa noticia e que nao precisa de mudar tudo de uma vez. O TaskForge suporta ambos os formatos em simultaneo, para que possa migrar gradualmente ao seu proprio ritmo.

Comece com tarefas complexas

Os melhores candidatos para migracao sao tarefas que ultrapassaram uma unica linha. Se se encontra a adicionar descricoes longas, multiplas subtarefas ou links de referencia a uma tarefa inline, essa tarefa e um candidato natural para o formato TaskNotes onde obtem o seu proprio ficheiro e espaco ilimitado para documentacao.

Mantenha tarefas simples inline

Nem toda tarefa precisa do seu proprio ficheiro. Acoes rapidas como 'Comprar mercearias' ou 'Responder ao email da Sara' funcionam perfeitamente como tarefas inline. Reserve o formato TaskNotes para tarefas que genuinamente beneficiam de metadados estruturados e notas detalhadas.

Use ambos os formatos em simultaneo

O TaskForge mostra tarefas inline e TaskNotes juntas na mesma lista de tarefas unificada. Nao precisa de se preocupar em misturar formatos - ambos os tipos aparecem nas suas listas personalizadas, vistas de calendario e widgets. A aplicacao trata da diferenca nos bastidores para que possa concentrar-se no seu trabalho.

Organize TaskNotes numa pasta dedicada

Crie uma pasta dedicada no seu vault para ficheiros TaskNotes, como 'Tasks' ou 'TaskNotes'. Isto mantem o seu vault organizado e facilita encontrar ficheiros de tarefas no explorador de ficheiros do Obsidian. Defina esta pasta como localizacao predefinida nas definicoes do TaskForge para que cada novo ficheiro TaskNotes va automaticamente para o sitio certo.

Migre em lotes

Em vez de converter todas as suas tarefas inline de uma vez, escolha um projeto ou uma area da sua vida para migrar primeiro. Mova as suas tarefas de trabalho para TaskNotes durante uma semana e veja como se sente. Quando estiver confortavel com o fluxo de trabalho, expanda para outras areas.

Pronto Para Experimentar TaskNotes?

Baixe o TaskForge e comece a usar o formato TaskNotes para seus fluxos de trabalho detalhados de gerenciamento de tarefas no Obsidian. Saiba mais sobre todas as capacidades do TaskNotes na nossa página de funcionalidades , e confira as últimas melhorias do TaskNotes para atualizações recentes.