MojoPad

Remember — Spaced Repetition

Your wiki can now make sure you remember what's in it. Turn any fact into a flashcard that lives inside the page it came from, and MojoPad schedules it with FSRS — the modern spaced-repetition algorithm behind today's Anki — showing each card just before you'd forget it. No separate deck app, no subscription, nothing leaves your Mac.

New to spaced repetition? The idea in one sentence: reviewing a fact just as you're about to forget it is what locks it into long-term memory — so instead of you deciding what to study, MojoPad tracks each card's forgetting curve and asks at the right moment. A few minutes when the 🎴 chip appears is all the habit takes.

Your first card, in under a minute

  1. On any page, type /flashcard and choose Flashcard. A card block appears with Question selected — type your question (say, “What year did the Suez Canal open?”).
  2. Click the Answer line below it and type the answer (“1869”). That's it — the card is live. It looks like a small callout box and behaves like any other block: edit it, move it, link from it.
  3. A 🎴 1 due chip appears in the status bar (new cards are ready immediately). Click it. The question appears alone; press space to reveal the answer.
  4. Now grade yourself honestly — that's the whole contract. Click Good (or press 3). The card is scheduled about three days out; the chip disappears; you're done. In three days it will be back, and each honest Good pushes it further into the future.

Cards live in pages

A flashcard is an ordinary block: the question is its title, the answer is its body. Type /flashcard on any page, or make cards straight from your writing:

  • Remember This (command palette) — select any sentence and the local model writes the question for it; the selection becomes the answer, and the card lands right under its source. Reading to remembering in one gesture.
  • Cloze — select the words to hide and the surrounding sentence becomes the question with […] where they were. Instant, no model needed.
  • ✦ Flashcards from this page — the model reads the page and proposes a set of Q&A cards; keep the good ones and they're appended.
  • On Markdown Pages a card is plain text — > [!card] Question ^id with the answer quoted below — so cards travel anywhere your files do.

Review

When cards come due, a 🎴 chip appears in the status bar (and today's daily note greets you with a one-line nudge). Click it, or run Review Due Cards:

  • Answer from memory first. Type your answer before flipping (optional) and the local model checks it on meaning — "right", "partly right — you swapped the kings", or "missed it" — and suggests the grade. You always have the last word.
  • Grade honestly: Again / Hard / Good / Easy, each button showing the real interval it would set. space reveals then grades Good; 14 grade directly; U takes back the last grade. A forgotten card returns later the same sitting.
  • Cards stay honest. If the page a card came from has changed since, review says so — ✦ Check asks the model whether the card still matches your notes, and one click heals it in place. Your cards can't quietly rot.
  • The queue interleaves across pages — consecutive cards change topic, which the learning research says beats studying in blocks.

What the grades actually do

The four buttons are how the scheduler learns your memory — each shows the interval it would set for this card, right now, so nothing is hidden:

  • Again — you'd forgotten it. The card returns in about ten minutes, this same sitting, and its future intervals shrink: the scheduler now knows this one is fragile.
  • Hard — you got there, slowly or shakily. The interval grows, but only a little.
  • Good — you knew it. This is the normal grade; intervals grow steadily (a new card runs roughly 3 days → 11 → 35 → months as you keep knowing it).
  • Easy — instant and effortless. The interval takes a big jump; use it sparingly or cards vanish over the horizon before they're truly settled.

Two things people worry about, answered: away for a month? Nothing breaks — overdue cards simply wait, the oldest surface first, and the scheduler accounts for the longer gap when you grade. Mis-tapped? Press U (or click ↩ Undo in the review header) and the last grade — schedule and history both — is taken back.

Reflections — spaced thinking

Not everything has one right answer. /reflection makes a 💭 card with an open question — "What would break if we doubled users?" — scheduled by the same engine. When it comes up, think, jot, and your thinking is added back to the source page, timestamped; the note accumulates your thoughts across sittings. Grade with Punt / Soon / Later / Much later.

Memory Stats and the optimizer

Memory Stats & Optimizer… (command palette) shows your cards, reviews, recall rate, what's due, and half a year of reviews as a heat-map with your 🔥 streak. And once enough history accumulates, one click fits the scheduler to your own memory: MojoPad re-derives all nineteen FSRS parameters from your review history — gradient descent on the recall predictions, entirely on your Mac — so intervals stretch where your memory is strong and tighten where it isn't. If your memory tracks the standard model, it says so honestly. Back to standard undoes it any time.

Concretely: the button unlocks at 200 scored reviews — a scored review is any review of a card you'd seen at least a day earlier (those are the ones that test real recall; same-day repeats don't count). The meter on the button shows your progress. Until then you're on the standard FSRS model, which is already excellent — the fit is a refinement, not a requirement, and re-fitting later (every month or two, as more history accumulates) keeps it sharp.

Housekeeping

  • Browse Flashcards… — every card in the wiki: search, jump to its page, and ⏸ suspend one to keep it while skipping its reviews.
  • Import Flashcards (Anki / CSV)… — bring an Anki collection over via its File ▸ Export ▸ Notes in Plain Text format (decks become pages), or any two-column CSV/TSV.
  • Schedules and the complete review log live in srs.json inside the document package — reviews never modify your pages, and the history travels with the document.

Good to know

  • No AI model? Everything essential still works. Cards, cloze, review, grading, scheduling, the optimizer, stats, import — all model-free. The model adds the luxuries: Remember This writes questions for you, ✦ drafts cards from a page, checks typed answers, and heals stale cards. Without one, Remember This still makes the card and just leaves the question for you to type.
  • Deleting a card is just deleting the block from its page — its review history stays in the log harmlessly. To keep a card but stop seeing it, suspend it in Browse Flashcards instead.
  • Duplicating a card (copying the block to another page) keeps only the first copy on the schedule — give the copy a fresh identity by deleting and re-creating it if you want both reviewed.
  • The chip counts what's due now; Memory Stats shows what's coming. A quiet chip means your memory is holding — that's the system working, not idle.

The graph has a memory too — see The Graph for the Memory Map, the Fading-knowledge lens, and the Undertow.