Show HN: DecksMD – local first, Markdown flashcards app and plugin for Obsidian
I started this project about a year ago when I was facing the problem that I needed flashcards to memorise thousands concepts and language vocabulary I kept forgetting and I hated every flashcards app out there so I decided to build something of my own and I started with markdown and obsidian. Fast forward one year later, I released the iOS and android apps too and a directory for ready made decks to share with people what Im learning, and also help other learners on their journey.
For me it was very interesting to build it because I had to come up with different conventions for what consists a flashcard while limiting myself only to markdown, so that the source text and the flashcard are one thing and they can be read also as a document, without custom syntax or delimiters cluttering it. Im still introducing new features as I explore new possibilities.
I built the foundations myself, algorithms, scheduler, parser. The part that was rough was finding a way to link headers to a state. At first Id just use the hash of the heading text to link it to the state in the database but that would break if you changed the text. So then I tried to use a string similarity algorithm to tie headings to same state, but that caused conflicts. In the end I ended up injecting a static ID on the heading body as a markdown comment. Obsidian hides it in live and reading views and it remains visible only in source mode view. Hate it from a purist perspective but it was a necessary compromise to guarantee a steady state that survives edits.
The app is free on android and as a plugin if you would like to try it. I charge a one time fee of 19.99 on iOS as a way to support the project, in a similar fashion to the Anki model.
Github: https://github.com/dscherdi/decks
I also occasionally post new decks in the directory for anymore interested in flashcards from different topics.
Directory: https://decksmd.app/decks/
Happy to answer any questions you might have.
Thanks for reading!
There are no comments yet.