Home Documentation
Documentation
Cancel

Documentation

How does it work?

Write your notes in Markdown and store them in .md files. Recall will scan your workspace folders, identify possible “flashcards” and test you using spaced repetition.

Notes:

  • To see your note rendered as HTML, simply use the Markdown Preview functionality of VS Code.
  • For more information on Markdown, please visit Markdown Guide.

How are flashcards identified

Screenshot

Recall scans all the .md files in you workspace and identifies flashcards using the following algorithm

  • at header level
    • any header marks a start of a new flashcard
    • any blank line marks a start of a new page (of that flashcard)
  • at bullet point level (when enabled)
    • any first level bullet point with of the configured type is a start of a new card
    • the bullet point is split using the line divider string (e.g. ::), configurable
    • the newline at the end of the bullet point also serves as a page divider
  • if a flashcard has at least two pages, it will be put in the testing queue

To better understand the above, look at the practical examples in the demo folder.

For example, the above screenshot comes from this paragraph

1
2
3
4
5
6
7
### decir

|Singular|Plural  |
|--------|--------|
|decía   |decíamos|
|decías  |decíais |
|decía   |decían  |

Note: If you want to prevent a page break, put a single space on the line. Make sure you have the files.trimTrailingWhitespace set to false, otherwise it will get removed when saving the file.

Testing yourself

To really train your memory, you should do a daily review of your cards. To run it, simply run the “Recall: Flashcards Test” command in VSCode (easiest way is to press Ctrl-P to see list of commands and start typing the name).

A webview will appear show you the first page of the first card to review. You then have the following options/hotkeys:

  • Space - expands the card and shows one more page (repeat until the card is fully expanded)
  • Enter - mark the card as remembered
  • F - mark the card as forgotten
  • N - go to the next card without logging any result
  • A - archive card - card won’t show for review anymore

Recall level

Every card has a so called “recall level” which indicates how well you remember it. It also represents the number of days after which it will be queued for review again.

All cards start with a default recall level of 1 which means the card will be queued for review the next day. If you mark it as remembered, the recall level will be doubled. If you mark it as forgotten, the recall level will be halved.

Reverse testing

Sometimes, you would like to test yourself in both directions. Best example of this is learning a vocabulary. Recall has this capability since version 0.8.0. Here’s how it works:

1
2
3
4
5
---
recall: bullet+
---

- el norte :: north

The “+” sign indicates that you want bi-directional testing in the current file. Now, once you archive the “el norte” card (signalling to Recall that you know it well enough in one direction) it will start showing in reverse, i.e. the front page will be “north” and the back page will be “el norte”. The card’s badge will also indicate that.

Before    After

Configuration

You can find the configuration options in Settings (Extensions -> Recall). Pay extra attention to these configuration options

  • Default Level - defines at which level to detect flashcards
    • ignore - no detection will be done
    • header - any header starts a new card
    • bullet - any “-“ bullet starts a new card (as well as a header)
    • asterisk - any “*” bullet starts a new card (as well as a header)
  • Line Divider - delimiter used in single line cards (use any string that works for you - colon, semicolon, slash, etc.), can even be multi-character sequence
  • New Card Limit - defines the maximum number of new cards allowed in one review session
    • defaults to 0, i.e. unlimited
    • you can use it to better pace the learning, e.g. when you add a large number of new cards at the same time
  • Hide badges - as card are detected in the text, the editor adds a small badge with the card’s state (NEW, GOOD, HARD, etc.) depending on the review results. This setting gives you the option to hide certain states if you wish, or even all of them.

If you need to override the default level of card recognition for a particular file, you can use the YAML header.

For example, to tell Recall that individual bullets should be recognized in the file, simply add the following sequence at the beginning of your .md file.

1
2
3
---
recall: bullet
---

Import from Mochi

To import export files from Mochi, you can run the Recall: Convert Mochi archive command, select a .mochi archive and for every deck in it a separate new Markdown file will be created. You can then save it anywhere you want.

If your Mochi deck contains media files (e.g. pictures), they will not be extracted. To extract them, simply unzip the .mochi file into a media subfolder and correct the links in the Markdown files accordingly. You can find all the links easily by searching for “@media”.

In certain cases, the import fails. This is due to a bug in the EDN parser library and would be difficult to correct. As a workaround, it is possible to unzip the .mochi file, convert the data.edn file to JSON using this tool, open the JSON file in VSCode and run the “Recall: Convert Mochi JSON” command.

Trending Tags