Pular para o conteúdo principal
TaskForge 3.0: a sua IA lê as suas tarefas.
Integração e Fluxos de Trabalho

Guia Completo para Tarefas Recorrentes no TaskForge

O TaskForge suporta tarefas recorrentes em dois formatos poderosos: Markdown e TaskNotes. Cada formato oferece vantagens únicas para diferentes fluxos de trabalho. Este guia explica como ambos funcionam, suas principais diferenças e quando usar cada um.

Por Que Dois Formatos?

O TaskForge oferece duas abordagens distintas para tarefas recorrentes, cada uma otimizada para diferentes casos de uso:

Formato Markdown

Perfeito para tarefas recorrentes simples em suas notas diárias e arquivos de projetos. Usa linguagem natural e cria novas instâncias de tarefas ao concluir. Ótimo para tarefas que precisam de um histórico visível.

Formato TaskNotes

Ideal para fluxos de trabalho recorrentes detalhados com uma tarefa por arquivo. Usa formato RRULE em YAML frontmatter e rastreia conclusões em um array complete_instances. Perfeito para tarefas que requerem metadados ricos e agendamento consistente.

Resumo: Principais Diferenças

Recurso Markdown TaskNotes
Configuração Linguagem natural com emoji 🔁 Formato RRULE em YAML frontmatter
Rastreamento de Conclusão Status muda para "concluído" Array complete_instances (status inalterado)
Criação de Instância Cria nova tarefa ao concluir Atualiza no local (mesma tarefa)
Data Base Auto-determinada (Prazo > Agendada > Início) Sempre usa data agendada
Deslocamento de Prazo Não mantido Mantido (padrão: habilitado)
Comportamento ao Desconcluir Muda status de volta (nova instância permanece) Remove de complete_instances, reverte data
Limites COUNT Emoji 🔢 com número ou posição/total Parâmetro COUNT em RRULE
Melhor Para Tarefas recorrentes simples, histórico visível Fluxos de trabalho detalhados, metadados ricos

Início Rápido: Modelos

Formato Markdown

Adicione tarefas recorrentes diretamente em seus arquivos markdown usando linguagem natural:

- [ ] Review weekly goals 🔁 every Monday 📅 2025-11-10
- [ ] Water plants 🔁 every 3 days ⏳ 2025-11-10
- [ ] Pay rent 🔁 every month on the 1st 📅 2025-12-01
- [ ] Backup files 🔁 every week when done 🛫 2025-11-10
- [ ] Team standup 🔁 every weekday 📅 2025-11-10
- [ ] Quarterly review 🔁 every 3 months 🔢 4 📅 2025-12-01

Formato TaskNotes

Crie uma-tarefa-por-arquivo com YAML frontmatter para fluxos de trabalho recorrentes detalhados:

---
title: Review weekly goals
status: todo
scheduled: 2025-11-10
due: 2025-11-10 17:00
recurrence: FREQ=WEEKLY;BYDAY=MO
tags:
  - work
  - review
complete_instances: []
---

## Notes
Review progress on all active projects.

Novo no TaskNotes? Confira nosso Guia de Integração TaskNotes para aprender sobre o formato uma-tarefa-por-arquivo e os conceitos básicos do YAML frontmatter.

Como a Recorrência Funciona

Entender como o TaskForge calcula a próxima ocorrência é crucial para ambos os formatos. O conceito chave é a data base, a data que é avançada quando você conclui uma tarefa recorrente.

Markdown: Determinação Automática da Data Base

Tarefas em Markdown determinam automaticamente a data base usando regras de precedência:

Precedência: Data de Prazo > Data Agendada > Data de Início

Se presente, a data de prazo torna-se a base. Caso contrário, a data agendada é usada. A data de início só é usada se nem prazo nem agendada estiverem presentes.

TaskNotes: Sempre Data Agendada

Tarefas recorrentes em TaskNotes sempre usam a data agendada como base para o cálculo de recorrência. Isso fornece comportamento consistente e previsível, independentemente de outros campos de data.

A data agendada é obrigatória para tarefas recorrentes em TaskNotes. Quando você conclui uma tarefa, o TaskForge adiciona a data de conclusão ao array complete_instances, calcula a próxima ocorrência a partir da data agendada e atualiza a data agendada para a próxima ocorrência não concluída.

Rastreamento de Conclusão

Os dois formatos adotam abordagens fundamentalmente diferentes para rastrear a conclusão de tarefas.

Markdown: Nova Instância ao Concluir

Quando você conclui uma tarefa recorrente em markdown, o status da tarefa original muda para "concluído" e uma nova instância de tarefa é criada com a data da próxima ocorrência, inserida após a original em seu arquivo.

Cria um histórico visível de tarefas concluídas em seu arquivo, perfeito para acompanhar o progresso ao longo do tempo.

TaskNotes: Array de Instâncias Completas

Quando você conclui uma tarefa recorrente em TaskNotes, a data de conclusão é adicionada ao array complete_instances, o campo de status nunca muda e a data agendada avança para a próxima ocorrência não concluída. DTSTART é adicionado automaticamente à recorrência na primeira conclusão.

Mantém um único arquivo de tarefa com histórico completo no array complete_instances. O status nunca muda, então a tarefa sempre aparece em sua lista de afazeres.

Quando Usar Cada Formato

Use Markdown Quando:

  • Você deseja um histórico visível de tarefas concluídas em seus arquivos
  • Você prefere linguagem natural ao invés de sintaxe RRULE
  • Você precisa de recorrência baseada em conclusão
  • Você está trabalhando com notas diárias ou arquivos de projetos

Use TaskNotes Quando:

  • Você deseja um único arquivo de tarefa com histórico completo
  • Você precisa de metadados ricos
  • Você deseja manter deslocamentos de prazo automaticamente
  • Você prefere a organização uma-tarefa-por-arquivo

Quais padrões de recorrência o TaskForge suporta?

O TaskForge suporta uma ampla gama de padrões de recorrência para ambos os formatos. Aqui esta uma visão geral completa de todas as opções disponíveis:

Padrões diários

A recorrência diária oferece agendamento simples para tarefas rotineiras. As opções incluem todos os dias, a cada N dias e todos os dias uteis (segunda a sexta). Use padrões diários para hábitos, rotinas e tarefas que precisam ser concluídas regularmente.

Padrões semanais

A recorrência semanal oferece agendamento flexível para tarefas que se repetem em dias específicos da semana. As opções incluem toda semana, a cada N semanas, toda segunda-feira, dias específicos ou qualquer combinação de dias.

Padrões mensais

A recorrência mensal da controle preciso sobre em qual dia do mês uma tarefa se repete. As opções incluem todo mês, a cada N meses, data especifica, ultimo dia do mês, dia da semana relativo ou múltiplos dias.

Padrões anuais

Padrões anuais são uteis para eventos e revisões anuais. Você pode configurar uma tarefa para se repetir todo ano, a cada N anos ou em meses específicos. Ideais para revisões anuais, lembretes de aniversario ou tarefas sazonais.

Padrões baseados em conclusão

A recorrência baseada em conclusão calcula a próxima ocorrência a partir da data em que você realmente concluiu a tarefa. No formato Markdown, use frases como "when done" ou "after completion". Especialmente útil para tarefas onde o intervalo entre ocorrências importa mais do que um cronograma fixo.

Limites de contagem e datas finais

Você pode limitar quantas vezes uma tarefa se repete. No formato Markdown, use o emoji de contagem seguido de um numero. No TaskNotes, use o parâmetro COUNT na sua RRULE. Também pode definir uma data final para parar a recorrência apos uma data especifica.

Padrões de enésimo dia da semana

Para tarefas que caem em um dia relativo do mês, o TaskForge suporta padrões de enésimo dia da semana. Você pode agendar tarefas para a primeira segunda-feira, ultima sexta-feira, segunda terça-feira de cada mês ou qualquer combinação semelhante.

Pronto para Aprender Mais?

Explore estes guias relacionados para dominar o TaskForge:

Ambos os formatos compartilham o mesmo mecanismo robusto de recorrência, garantindo agendamento confiável independentemente do formato escolhido. E você nunca fica preso, você pode misturar ambos os formatos no mesmo cofre e migrar entre eles conforme suas necessidades evoluem. Explore todas as funcionalidades de recorrência ou obtenha ajuda para configurar tarefas recorrentes.

Azhar Dewji
Azhar Dewji · 10 de novembro de 2025 · Atualizado em 18 de julho de 2026

Engenheiro de software com mais de 10 anos de experiência no desenvolvimento de aplicações móveis e de secretária em Swift, Kotlin e Flutter. Programador independente radicado em Toronto, Canadá. Criador do TaskForge. Saiba mais