DecksMD 2.1.0

Decks 2.1.0 Release Notes

🚀 Major Addition: The Spaced Repetition Migrator

Coming from the Spaced Repetition plugin? Decks 2.1.0 introduces a built-in one-click migrator that allows you to jump to Decks without losing your progress. The migrator extracts your legacy cards into clean Decks decks, rewrites each note into readable prose, and carries over your review history. You can pick up your reviews exactly right where you left off.

To get started, open the migrator from the deck panel toolbar using the cube icon or run the "Migrate from Spaced Repetition plugin" command.

How the Migrator Works

• Completely Non-Destructive: Your original notes are never touched. Migration is additive, meaning it writes new files into a chosen target folder while mirroring your structure.
• Clean File Separation: Each note is split into two clean files. A flashcards deck (named <Note> (Flashcards)) holds the extracted cards, and a separate readable note keeps the original prose.
• Syntax De-sugaring: Card syntax within the readable note is de-sugared into normal text. For example, :: and ::: become " — ", ? and ?? join the question and answer, and clozes are restored to their answer.
• Frontmatter Cross-linking: The newly generated files are automatically cross-linked. The readable note receives a Flashcards property pointing to its deck, and both files receive an Origin note property pointing back to the original.
• Reversed Cards: A Front ::: Back card is expanded into a forward card and a swapped card in the same deck file. This ensures each direction is scheduled independently.
• Context Flattening: Nested structures, such as ancestor headings and nested list bullets, are flattened into the card's front. This captures the whole path for context, rendered at your profile's single header level.
• Smart Auto-routing: Short single-line cards automatically become rows in a compact table to prevent endless scrolling. Multi-line cards containing code blocks, lists, or math become headers so their formatting survives.
• Whole-note Reviews: Notes reviewed as a whole using the #review tag become Decks title-mode cards under a dedicated profile.
• FSRS-6 State Translation: Your scheduling state is translated directly to FSRS-6. Decks reads the legacy <!--SR:--> metadata and maps it to a stability/difficulty/due state so you resume without restarting.