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 ● guardado

---

status: in-progress

priority: high

due: 2025-10-15

---

# Rever a PR

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

O frontmatter guarda o estado, a prioridade e a data de vencimento da tarefa. O corpo é teu, para notas, links e o que mais o trabalho precisar.

Grátis - iOS e Mac

Grátis - Android 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 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 ficheiros de tarefa 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 ficheiros de tarefa e organize-os da maneira que funcione para a estrutura do seu cofre.

Exemplo de Ficheiro de Tarefa

Veja como é um ficheiro de tarefa típico no seu cofre Obsidian:

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

# Rever a PR #123

Reveja a nova PR do sistema de autenticação e dê feedback sobre:

- [ ] Qualidade do código e padrões
- [ ] Cobertura de testes
- [ ] Completude da documentação
- [ ] Considerações de segurança

## Notas

- É preciso verificar a nova lógica de renovação do token
- Verificar se o rate limiting está implementado corretamente
- Testar com vários níveis de permissão de utilizador

## Ligações

- [[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 Ficheiros de Tarefa

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 ficheiros de tarefa: 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 ficheiros de tarefa devem ser criados. Isso ajuda a manter seu cofre organizado.
4

Escolha o Formato Padrão

Decida se novas tarefas devem ser criadas como ficheiros de tarefa 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.

Ficheiros de Tarefa vs. Tarefas Inline

Use Ficheiros de Tarefa 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 ficheiros de tarefa para grandes projetos e tarefas inline para itens de ação rápidos - tudo em uma vista de lista unificada.

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

Para além do básico da gestão de uma tarefa por ficheiro, o TaskNotes oferece varias funcionalidades avançadas que lhe permitem adaptar o sistema ao seu fluxo de trabalho exato. Estas opções são especialmente uteis se já tem uma estrutura de vault estabelecida ou convenções especificas para organizar as suas notas.

Mapeamento de campos personalizado

Se o seu vault já usa nomes de propriedades YAML diferentes, não 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 de tarefa são nomeados usando variáveis 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 criação, facilitando a ordenação cronológica 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 de tarefa. Se quer sempre uma secção de Notas, uma secção de Lista de Verificacao e uma secção de Ligações nos seus ficheiros de tarefas, configure um modelo uma vez e cada nova tarefa começa 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 liga-la a um projeto especifico, ou @escritório para indicar onde o trabalho deve ser feito. Estas anotações 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 ficheiros de tarefa?

Se tem usado tarefas inline e quer começar a tirar partido dos ficheiros de tarefa, a boa noticia e que não precisa de mudar tudo de uma vez. O TaskForge suporta ambos os formatos em simultâneo, para que possa migrar gradualmente ao seu próprio ritmo.

Comece com tarefas complexas

Os melhores candidatos para migração são tarefas que ultrapassaram uma única linha. Se se encontra a adicionar descrições longas, múltiplas subtarefas ou links de referencia a uma tarefa inline, essa tarefa e um candidato natural para o formato TaskNotes onde obtém o seu próprio ficheiro e espaço ilimitado para documentacao.

Mantenha tarefas simples inline

Nem toda tarefa precisa do seu próprio ficheiro. Acoes rápidas 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 simultâneo

O TaskForge mostra tarefas inline e ficheiros de tarefa juntos na mesma vista de lista unificada. Não precisa de se preocupar em misturar formatos - ambos os tipos aparecem nas suas listas personalizadas, vistas de calendário e widgets. A aplicação trata da diferença nos bastidores para que possa concentrar-se no seu trabalho.

Organize ficheiros de tarefa numa pasta dedicada

Crie uma pasta dedicada no seu vault para ficheiros de tarefa, como 'Tasks' ou 'Ficheiros de Tarefa'. Isto mantém o seu vault organizado e facilita encontrar ficheiros de tarefas no explorador de ficheiros do Obsidian. Defina esta pasta como localizacao predefinida nas definições do TaskForge para que cada novo ficheiro de tarefa vá 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 ficheiros de tarefa durante uma semana e veja como se sente. Quando estiver confortável 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.

Descarregar para Windows

Aviso para Linux

Nesta página