Integracao

3 de novembro de 2025

Guia de Integracao 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 documentacao detalhada de tarefas, metadados ricos e fluxos de trabalho estruturados de anotacoes.

Integracao TaskNotes do TaskForge no macOS mostrando uma tarefa por arquivo com frontmatter YAML

Baixar Grátis - iOS e Mac

Baixar Grátis - Android

Ver Todos os Recursos

O Que e o Formato TaskNotes?

TaskNotes e 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 proprio arquivo dedicado com propriedades estruturadas e bastante espaco para documentacao detalhada.

Uma Tarefa Por Arquivo

Cada tarefa vive em seu proprio arquivo markdown, dando espaco ilimitado para notas, anexos e documentacao.

Frontmatter YAML

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

Identificacao Flexivel

Identifique TaskNotes por tag ou propriedade personalizada. Escolha o metodo que melhor se ajusta ao seu fluxo de trabalho.

Pastas Configuraveis

Defina uma pasta padrao para novos TaskNotes e organize-os como funcionar para a estrutura do seu cofre.

Exemplo de Arquivo TaskNotes

Veja como um arquivo TaskNotes tipico 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 conclusao da tarefa: a-fazer, em-andamento, em-espera, planejado ou concluido

status: in-progress

Prioridade

Importancia da tarefa: mais-alta, alta, media, baixa ou mais-baixa

priority: high

Datas

Datas de vencimento, datas agendadas, datas de inicio e datas de conclusao

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

Recorrencia

Configure tarefas recorrentes com intervalos flexiveis

recurrence: every week

Configurando TaskNotes

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 Metodo de Identificacao

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

Defina Pasta Padrao

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

Escolha Formato Padrao

Decida se novas tarefas devem ser criadas como TaskNotes ou tarefas inline por padrao. Voce sempre pode substituir isso por lista personalizada.
5

Personalize Mapeamento de Campos (Opcional)

Avancado: Personalize os nomes de propriedade YAML se voce usa nomes de campo diferentes no seu cofre.

TaskNotes vs. Tarefas Inline

Use TaskNotes Quando:

Voce precisa de documentacao detalhada de tarefas
Tarefas requerem multiplas notas e anexos
Voce prefere metadados estruturados
Tarefas sao projetos complexos
Voce quer arquivos de tarefa pesquisaveis

Use Tarefas Inline Quando:

Tarefas sao itens de acao simples
Tarefas pertencem a notas de reuniao
Voce prefere tarefas incorporadas no contexto
Captura rapida e prioridade
Voce usa o plugin Obsidian Tasks

Boa noticia: Voce nao precisa escolher! O TaskForge suporta ambos os formatos lado a lado. Use TaskNotes para grandes projetos e tarefas inline para itens de acao rapidos - tudo em uma lista de tarefas unificada.

Quais funcionalidades avancadas do TaskNotes estao disponiveis?

Alem do basico do gerenciamento de uma tarefa por arquivo, o TaskNotes oferece diversas funcionalidades avancadas que permitem adaptar o sistema ao seu fluxo de trabalho exato. Essas opcoes sao especialmente uteis se voce ja tem uma estrutura de vault estabelecida ou convencoes especificas para organizar suas notas.

Mapeamento de campos personalizado

Se seu vault ja usa nomes de propriedades YAML diferentes, voce nao precisa muda-los. O TaskForge permite remapear os nomes de campos padrao para corresponder aos seus. Por exemplo, se voce 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 TaskNotes sao nomeados usando variaveis como {title}, {date} e {priority}. Por exemplo, voce poderia definir o formato como '{date}-{title}' para que cada arquivo de tarefa comece com sua data de criacao, facilitando a classificacao cronologica dos arquivos no explorador de arquivos do Obsidian.

Templates de corpo

Defina um template de corpo markdown padrao que e inserido em cada novo arquivo TaskNotes. Se voce sempre quer uma secao de Notas, uma secao de Checklist e uma secao de Links nos seus arquivos de tarefas, configure um template uma vez e cada nova tarefa comecara 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 vincula-la a um projeto especifico, ou @escritorio para indicar onde o trabalho deve ser feito. Essas anotacoes funcionam junto com tags regulares, oferecendo uma forma mais rica de categorizar e filtrar tarefas no seu vault.

Como migrar de tarefas inline para TaskNotes?

Se voce tem usado tarefas inline e quer comecar a aproveitar o TaskNotes, a boa noticia e que voce nao precisa mudar tudo de uma vez. O TaskForge suporta ambos os formatos simultaneamente, entao voce pode migrar gradualmente no seu proprio ritmo.

Comece com tarefas complexas

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

Mantenha tarefas simples inline

Nem toda tarefa precisa de seu proprio arquivo. Acoes rapidas 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 TaskNotes juntas na mesma lista de tarefas unificada. Voce nao precisa se preocupar em misturar formatos - ambos os tipos aparecem nas suas listas personalizadas, visualizacoes de calendario e widgets. O app lida com a diferenca nos bastidores para que voce possa focar no seu trabalho.

Organize TaskNotes em uma pasta dedicada

Crie uma pasta dedicada no seu vault para arquivos TaskNotes, como 'Tasks' ou 'TaskNotes'. Isso mantem seu vault organizado e facilita encontrar arquivos de tarefas no explorador de arquivos do Obsidian. Defina essa pasta como local padrao nas configuracoes do TaskForge para que cada novo arquivo TaskNotes va 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 area da sua vida para migrar primeiro. Mova suas tarefas de trabalho para TaskNotes por 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 sobre todas as capacidades do TaskNotes na nossa pagina de recursos , e confira as ultimas melhorias do TaskNotes para atualizacoes recentes.