README file from
GithubSimple Flashcards
RemNote-style flashcards for Obsidian. Write cards inline in your notes with simple delimiters, then review them with optional spaced repetition.
Install
Copy main.js, manifest.json, and styles.css into
<your-vault>/.obsidian/plugins/simple-flashcards/, then enable
Simple Flashcards under Settings → Community plugins.
The ::: block — where cards live
Cards are only read inside a block. A bullet ending with ::: opens a
block; each of its direct child bullets becomes a card if it contains a
delimiter. Plain bullets, deeper-nested bullets, and anything outside a :::
block are ignored — so template files, LaTeX math, and ordinary prose are
never mistaken for cards.
- French vocab :::
- Capital of France :: Paris
- el perro >> the dog
- just a note to myself <- no delimiter, ignored
Card delimiters
| Syntax | Example | Result |
|---|---|---|
:: basic |
Capital of France :: Paris |
front → back |
>> forward |
Question >> Answer |
front → back |
<< backward |
Answer << Question |
prompts from the right side |
<> bidirectional |
uno <> one |
two cards, one each direction |
{} cloze |
The sky is {blue} |
fill-in-the-blank |
;; multiline |
Planets ;; |
answer is the bullet's own sub-bullets |
Grouped clozes — number them so several blanks hide together as one card:
- Geography :::
- {1|Paris} is the capital of {1|France}; {2|Berlin} is in Germany.
Multiline answer — the ;; bullet's children are its answer:
- Astronomy :::
- Inner planets ;;
- Mercury
- Venus, Earth, Mars
Decks
Tag a card with #deck/Name to file it into a deck (nesting allowed:
#deck/Spanish/Verbs). Put the tag on the ::: header to deck the whole
block, on a single card line to deck just that card, or anywhere in the note as
a default. Cards with no tag go to the Default deck. The deck prefix
(deck) is configurable in settings.
Reviewing
Open the command palette and run any of:
- Review due cards (whole vault) — review everything that's due. Also on the ribbon (layers icon).
- Review a deck… — pick a deck from a list showing due/new counts.
- Review current note — review only this note's cards.
- Toggle inline review for current note — review in place: answers blur, click Reveal, then rate without leaving the note.
In the review modal: Show answer (or Space), then rate Again / Hard /
Good / Easy (or keys 1–4). Suspend card removes it from rotation.
If spaced repetition is turned off in settings, review is a plain flip-through.
Browsing & editing
- Browse all flashcards — a searchable list of every card with its deck, type, and status; click a row to jump to that line in the note.
- Right-click a card line for: review this card, reset schedule, suspend / unsuspend.
Spaced repetition
Scheduling uses the SM-2 algorithm. Intervals, ease, and due dates are stored
in the plugin's own data.json — your notes are never modified. If you edit a
card's text, the plugin fuzzy-matches it back to its original schedule so your
progress isn't lost.
Settings
- Spaced repetition — enable/disable; tune starting ease, easy bonus, hard factor, and new-cards-per-session.
- Decks — change the deck tag prefix.
- Appearance — toggle live-preview styling of card delimiters.
- Card syntax — enable or disable each delimiter type individually.