1

Pitch: Plain Deck, flashcards no Obsidian - com progresso salvo na própria nota

Eu estudo usando notas no Obsidian, mas sempre que queria revisar com repetição espaçada precisava levar o conteúdo para o Anki ou aceitar plugins que guardam o histórico de revisão num banco separado.

Então fiz o Plain Deck, um plugin open source (MIT) que transforma notas comuns em flashcards e agenda as revisões com FSRS-6, o mesmo algoritmo que o Anki usa hoje.

Plain Deck em uso

Como um deck funciona

Qualquer nota com nome terminado em .cards.md vira um deck. Cada título ## é uma pergunta e as linhas abaixo dele são a resposta:

## O que faz o git rebase?
Reaplica os commits de um branch em cima de outro, reescrevendo o histórico.

## Diferença entre merge e rebase
O merge cria um commit novo que junta os dois históricos.
?
O rebase deixa o histórico linear, mas muda os hashes dos commits.

Uma linha só com ? divide o card em partes de pergunta e resposta. Também dá para estudar qualquer nota pelo menu de botão direito, sem renomear nada.

Como o card é Markdown puro, ele continua legível no modo de leitura, no GitHub e em qualquer outro editor. Imagens, embeds, fórmulas, blocos de código, tabelas, callouts e links internos são renderizados normalmente na revisão.

Decisão 1: o progresso mora dentro da nota

Essa foi a decisão que mais pesou. Os plugins que eu conhecia guardam o estado de cada card num arquivo à parte, como um banco SQLite na pasta do plugin. Funciona, mas o histórico fica separado do conteúdo.

No Plain Deck, depois de cada revisão o plugin escreve uma linha de comentário oculto logo abaixo do título do card:

...

## What is the difference between replication and sharding?
<!-- srs: learning step=1 due=2026-11-01T03:33:28Z last=2026-11-01T03:23:28Z s=2.3065 d=2.1181 reps=1 lapses=0 -->
Replication stores copies of the **same** data on several nodes; sharding splits the data into pieces and
stores **different** pieces on different nodes.

They are usually combined: each shard is itself replicated for fault tolerance.

...

O que isso me deu:

  • Sincronização de graça. Obsidian Sync, iCloud ou git levam o progresso junto com a nota, sem nenhum serviço extra no meio.
  • Reset trivial. Apagou a linha, o card volta a ser novo.
  • Nada escondido. Dá para ver e editar o estado com qualquer editor de texto.

O custo: a nota muda a cada revisão, então quem versiona o vault no git vai ver esses diffs. O que não é um problema no meu caso.

Decisão 2: não sobrescrever revisão de outro aparelho

Se você revisa no celular e depois no computador, as duas cópias da nota podem estar diferentes por alguns segundos. Por isso o plugin relê a versão atual da nota antes de cada escrita, em vez de confiar no que tinha em memória. Assim uma revisão feita em outro aparelho não é apagada.

Decisão 3: FSRS-6 implementado do zero

O FSRS estima, para cada card, o quanto você já fixou aquele conteúdo e o quanto ele é difícil, e marca a próxima revisão para o momento em que a chance de lembrar cai até a retenção desejada. O agendador do Plain Deck é uma reimplementação do FSRS-6 que segue a biblioteca ts-fsrs (MIT).

O padrão vem assim, e tudo pode ser ajustado por deck:

ConfiguraçãoPadrão
Retenção desejada90%
Cards novos por sessão20
Passos de aprendizado1 min, 10 min
Passo de reaprendizado10 min
O dia vira às4:00

Extra: decks escritos por IA

O repositório tem uma skill para agentes de IA (como o Claude) que ensina o formato, além de um script check-deck.mjs que valida o deck gerado. Na prática: você pede ao agente um deck a partir de uma nota sua, roda o checker e abre no Plain Deck.

Privacidade

Funciona offline. Não faz requisições de rede, não tem telemetria, anúncio nem conta. Só escreve nas notas de deck e no próprio arquivo de configurações.

Como testar

No Obsidian, abra Configurações > Plugins da comunidade, procure "Plain Deck" e instale. Funciona no desktop e no celular. O repositório tem um deck de exemplo em português para começar.

O que eu queria saber de vocês

  1. Guardar o progresso dentro da nota é uma vantagem para você ou o diff a cada revisão atrapalha?
  2. Quem usa Anki: o que falta aqui para você estudar só no Obsidian?

Estou lendo todos os comentários e as issues no GitHub.
Muito obrigado pessoal!

Carregando publicação patrocinada...