Pular para o conteúdo principal
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 padroes de recorrencia o TaskForge suporta?

O TaskForge suporta uma ampla gama de padroes de recorrencia para ambos os formatos. Aqui esta uma visao geral completa de todas as opcoes disponiveis:

Padroes diarios

A recorrencia diaria oferece agendamento simples para tarefas rotineiras. As opcoes incluem todos os dias, a cada N dias e todos os dias uteis (segunda a sexta). Use padroes diarios para habitos, rotinas e tarefas que precisam ser concluidas regularmente.

Padroes semanais

A recorrencia semanal oferece agendamento flexivel para tarefas que se repetem em dias especificos da semana. As opcoes incluem toda semana, a cada N semanas, toda segunda-feira, dias especificos ou qualquer combinacao de dias.

Padroes mensais

A recorrencia mensal da controle preciso sobre em qual dia do mes uma tarefa se repete. As opcoes incluem todo mes, a cada N meses, data especifica, ultimo dia do mes, dia da semana relativo ou multiplos dias.

Padroes anuais

Padroes anuais sao uteis para eventos e revisoes anuais. Voce pode configurar uma tarefa para se repetir todo ano, a cada N anos ou em meses especificos. Ideais para revisoes anuais, lembretes de aniversario ou tarefas sazonais.

Padroes baseados em conclusao

A recorrencia baseada em conclusao calcula a proxima ocorrencia a partir da data em que voce realmente concluiu a tarefa. No formato Markdown, use frases como "when done" ou "after completion". Especialmente util para tarefas onde o intervalo entre ocorrencias importa mais do que um cronograma fixo.

Limites de contagem e datas finais

Voce pode limitar quantas vezes uma tarefa se repete. No formato Markdown, use o emoji de contagem seguido de um numero. No TaskNotes, use o parametro COUNT na sua RRULE. Tambem pode definir uma data final para parar a recorrencia apos uma data especifica.

Padroes de enesimo dia da semana

Para tarefas que caem em um dia relativo do mes, o TaskForge suporta padroes de enesimo dia da semana. Voce pode agendar tarefas para a primeira segunda-feira, ultima sexta-feira, segunda terca-feira de cada mes ou qualquer combinacao 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 · · Updated July 8, 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