Skip to content

AB1908/obsidian-moon-reader

Repository files navigation

Obsidian Moon Reader

NOTE: This plugin is in alpha so please ensure you have backed up your vault and have file recovery turned on!

How To Use

  1. Install this plugin using TfTHacker's BRAT.

  2. Configure the folder where .mrexpt exports from Moon+ Reader are stored. I use a root folder named "Book Exports".

    Note: This must be in your Obsidian Vault.

  3. Navigate to an open file where you want to dump the markdown. This can be an existing file or a new file. Text will be appended at the end of the file.

  4. Use the command palette to parse an export from Moon+ Reader. The command is named "Parse an export".

  5. Choose the color of which annotations you want to import.

Note that this is a one time processing and will keep being appended to if you rerun it. Incremental processing (i.e. processing only the change) will come at a later time.

What is currently supported?

Very little to be honest. You can only import a single color's worth of highlights at the moment. The export format uses Obsidian callouts and looks like so:

> [!color hexcode]
> highlight text
> ***
> note text

Sample output:

> [!FF33AA]
> Down the rabbit hole
> ***
> Here we go!

SRS Support

Turn on the toggle in the settings to enable exports that are compatible with my Card Coverage plugin. This changes the export format to:

> [!notes] 39182
> Down the rabbit hole
> ***
> Here we go!

where 39182 is an ID generated by Moon+ Reader when exporting. When annotating, you can mark a header with # to turn it into an H1, ## to turn it into an H2, and so on. I plan to try fetching these automatically from an EPUB in the future to save me some hassle when reading books.

To do

This is by no means a guarantee of what will be implemented. There are no timelines whatsoever.

  • Allow importing all colors of annotations at once
  • Allow filtering by annotation types (underlines vs highlights)
  • Export templates
  • API support
  • Better export file handling (only supports a single folder for now)
  • Use frontmatter more effectively
  • Better incremental exports