Skip to content
DecksMD DecksMD DecksMD

FAQ & troubleshooting

My note isn’t showing up as a deck

Section titled “My note isn’t showing up as a deck”
  • Make sure the file has the #decks tag (in frontmatter or as an inline tag).
  • Check your search path in settings — if it’s restricted to a folder, notes outside it are ignored.
  • Confirm your cards use the configured header level (H2 by default). Headings above that level become breadcrumbs, not cards.

A heading didn’t become a card

Section titled “A heading didn’t become a card”

Only headings at the configured level become cards. Headings above it are treated as a breadcrumb path for context. Change the header level in the deck’s profile, or use Title to turn the whole file into one card.

My table isn’t parsing

Section titled “My table isn’t parsing”

Tables must sit directly under a header, with no other paragraphs between the header and the table. The first column is the front, the second is the back, and the header row is ignored. See Tables.

Image occlusion or cloze isn’t working

Section titled “Image occlusion or cloze isn’t working”

Image occlusion is built on cloze, so cloze must be enabled on the deck’s profile (it is by default). Make sure each label is wrapped in ==highlights==.

I edited a card — when does it update?

Section titled “I edited a card — when does it update?”

Cards sync automatically when you save the note. If you don’t see a change, it may be waiting for the next background refresh; you can also reopen the deck panel.

Will I lose progress if I delete and rewrite a card?

Section titled “Will I lose progress if I delete and rewrite a card?”

No. When you recreate a card with the same front, DecksMD restores its previous FSRS state from the review history. See Card formats overview.

How do I review the same cards across files?

Section titled “How do I review the same cards across files?”

Use a custom deck with a tag filter — for example every card tagged #exam, no matter which note it’s in.

My phone and desktop are out of sync

Section titled “My phone and desktop are out of sync”

DecksMD relies on your vault sync provider (iCloud, Obsidian Sync, Dropbox, Syncthing). Small per-device logs sync in 15–30 seconds; the full database syncs more slowly. See Multi-device sync for how it works and how conflicts are handled.

Are the AI features required?

Section titled “Are the AI features required?”

No. AI is off until you add your own API key, and the plugin makes no network calls unless you explicitly trigger an action. See AI assistance.

Still stuck?

Section titled “Still stuck?”