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.

Review PR.md ● salvo

---

status: in-progress

priority: high

due: 2025-10-15

---

# Revisar a PR

- [ ] Qualidade do código e padrões

O frontmatter guarda o status, a prioridade e a data de vencimento da tarefa. O corpo é seu, para anotações, links e o que mais o trabalho precisar.

Baixar Grátis - iOS e Mac

Baixar Grátis - Android Baixar Grátis - Windows

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 espalhadas pelas suas notas, TaskNotes da a cada tarefa seu próprio arquivo dedicado com propriedades estruturadas e bastante espaço para documentação detalhada.

Uma Tarefa Por Arquivo

Cada tarefa vive em seu próprio arquivo markdown, dando espaço ilimitado para notas, anexos e documentação.

Frontmatter YAML

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

Identificação Flexível

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

Pastas Configuráveis

Defina uma pasta padrão para novos arquivos de tarefa e organize-os como funcionar para a estrutura do seu cofre.

Exemplo de Arquivo de Tarefa

Veja como um arquivo de tarefa típico se parece 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: a-fazer, em-andamento, em-espera, planejado ou concluído

status: in-progress

Prioridade

Importância da tarefa: mais-alta, alta, média, baixa ou mais-baixa

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 Arquivos de Tarefa

1

Enable Arquivos de Tarefa

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

Escolha Método de Identificação

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

Defina Pasta Padrão

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

Escolha Formato Padrão

Decida se novas tarefas devem ser criadas por padrão como arquivos de tarefa ou como tarefas inline. Você sempre pode mudar isso em cada espaço personalizado.
5

Personalize Mapeamento de Campos (Opcional)

Avançado: Personalize os nomes de propriedade YAML se você usa nomes de campo diferentes no seu cofre.

Arquivos de Tarefa vs. Tarefas Inline

Use Arquivos de Tarefa Quando:

Você precisa de documentação detalhada de tarefas
Tarefas requerem múltiplas notas e anexos
Você prefere metadados estruturados
Tarefas são projetos complexos
Você quer arquivos de tarefa pesquisáveis

Use Tarefas Inline Quando:

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

Boa noticia: Você não precisa escolher! O TaskForge suporta ambos os formatos lado a lado. Use arquivos de tarefa para grandes projetos e tarefas inline para itens de ação rápidos - tudo em uma visualização de lista unificada.

Quais funcionalidades avançadas do TaskNotes estão disponíveis?

Além do básico do gerenciamento de uma tarefa por arquivo, o TaskNotes oferece diversas funcionalidades avançadas que permitem adaptar o sistema ao seu fluxo de trabalho exato. Essas opções são especialmente úteis se você já tem uma estrutura de cofre estabelecida ou convenções específicas para organizar suas notas.

Mapeamento de campos personalizado

Se seu cofre já usa nomes de propriedades YAML diferentes, você não precisa mudá-los. O TaskForge permite remapear os nomes de campos padrão para corresponder aos seus. Por exemplo, se você usa 'state' em vez de 'status' ou 'importance' em vez de 'priority', pode configurar o TaskForge para ler e gravar esses campos diretamente.

Formatos personalizados de nomes de arquivos

Controle exatamente como os novos arquivos de tarefa são nomeados usando variáveis como {title}, {date} e {priority}. Por exemplo, você poderia definir o formato como '{date}-{title}' para que cada arquivo de tarefa comece com sua data de criação, facilitando a classificação cronológica dos arquivos no explorador de arquivos do Obsidian.

Templates de corpo

Defina um template de corpo markdown padrão que e inserido em cada novo arquivo de tarefa. Se você sempre quer uma seção de Notas, uma seção de Checklist e uma seção de Links nos seus arquivos de tarefas, configure um template uma vez e cada nova tarefa começará com essa estrutura.

Projetos e contextos

O TaskNotes suporta anotações de projeto e contexto usando a sintaxe +NomeProjeto e @contexto. Marque uma tarefa com +RedesignWebsite para vinculá-la a um projeto específico, ou @escritório para indicar onde o trabalho deve ser feito. Essas anotações funcionam junto com tags regulares, oferecendo uma forma mais rica de categorizar e filtrar tarefas no seu cofre.

Como migrar de tarefas inline para Arquivos de Tarefa?

Se você tem usado tarefas inline e quer começar a aproveitar os arquivos de tarefa, a boa notícia é que você não precisa mudar tudo de uma vez. O TaskForge suporta ambos os formatos simultaneamente, então você pode migrar gradualmente no seu próprio ritmo.

Comece com tarefas complexas

Os melhores candidatos para migração são tarefas que ultrapassaram uma única linha. Se você se vê adicionando descrições longas, múltiplas subtarefas ou links de referência a uma tarefa inline, essa tarefa é um candidato natural para o formato TaskNotes onde ela ganha seu próprio arquivo e espaço ilimitado para documentação.

Mantenha tarefas simples inline

Nem toda tarefa precisa de seu próprio arquivo. Ações rápidas como 'Comprar mantimentos' ou 'Responder o e-mail da Sara' funcionam perfeitamente como tarefas inline. Reserve o formato TaskNotes para tarefas que genuinamente se beneficiam de metadados estruturados e notas detalhadas.

Use ambos os formatos simultaneamente

O TaskForge mostra tarefas inline e arquivos de tarefa juntos, na mesma visualização de lista unificada. Você não precisa se preocupar em misturar formatos: os dois tipos aparecem nos seus espaços personalizados, nas visualizações de calendário e nos widgets. O app cuida da diferença nos bastidores para você se concentrar no seu trabalho.

Organize Arquivos de Tarefa em uma pasta dedicada

Crie uma pasta dedicada no seu cofre para arquivos de tarefa, como 'Tasks' ou 'Arquivos de Tarefa'. Isso mantém seu cofre organizado e facilita encontrar arquivos de tarefas no explorador de arquivos do Obsidian. Defina essa pasta como local padrão nas configurações do TaskForge para que cada novo arquivo de tarefa vá automaticamente para o lugar certo.

Migre em lotes

Em vez de converter todas as suas tarefas inline de uma vez, escolha um projeto ou uma área da sua vida para migrar primeiro. Mova suas tarefas de trabalho para arquivos de tarefa por uma semana e veja como se sente. Quando estiver confortável com o fluxo de trabalho, expanda para outras áreas. Essa abordagem gradual permite refinar o mapeamento de campos e os modelos antes de se comprometer de vez.

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 sobre todas as capacidades do TaskNotes na nossa página de recursos , e confira as últimas melhorias do TaskNotes para atualizações recentes.

Baixar para Windows

Aviso para Linux

Nesta página