I’ve been trying out Dendron for managing my personal knowledge and notes. When I saw that there were no vscode plugins that appear to sync with Hypothesis and given my own use of hypothesis for literature notes and my recent Joplin integration attempt, I couldn’t help myself.

Introducing Markdown Hypothesis Sync a plugin for Visual Studio Code and VSCodium that allows you to download your hypothesis annotations and any quotations in context and store them in your markdown-based second brain.

a screen recording of the plugin in action

The plugin comes with built in Dendron integration so that the required markdown frontmatter records can automatically be generated immediately after sync by running Dendron Doctor.

The plugin uses a frontmatter attribute called hypothesisURI to track which markdown file is associated with which website that you have annotated and it uses HTML comments which are invisible in rendered markdown to track where each annotation begins and ends within files.

That means that it’s possible for you to move and rename your notes and add more detail to the markdown file without the plugin losing information or getting confused. It also means that if you add more annotations to a site you annotated before they can be added to your markdown file incrementally.

I’m really enjoying Dendron so far and, I’m publishing a subset of my permanent notes and useful links as a static digital garden here. This has been a fun weekend hack that has allowed me to have a go at learning to build VS Code plugins.

If you end up using my plugin, please share your experience with me over on fosstodon, by email.

Although I have switched to Dendron for now, I plan on updating my existing Joplin plugin with some of the new functionality I developed for the VSCode tool soon (specifically, the ability to have a single note contain multiple annotations versus the current tool which creates new notes per annotation).