HYPOTHESIS

Import your Hypothesis notes and highlights into Roam!

This extension is available in Roam Depot! Install it directly from Roam by navigating to Settings > RoamDepot > Browse. To help test a development version of the extension before it's available in Roam Depot, click here to download.

Hypothesis

Integrate your Hypothesis account with Roam!

Usage

This extension includes Roam Command Palette & SmartBlock commands designed to pull in annotations from Hypothes.is. To get started,

1. Register for a free user account at Hypothes.is
2. Copy your free developer key from Hypothes.is which can be obtained at: https://hypothes.is/account/developer
3. Add the Hypothesis User Token API in your Roam Depot Settings

The output format for the block for a highlight can be customized. You can specify this format in your Roam Depot Settings. The template will replace HIGHLIGHT for where the highlight text should appear and URL for where the URL to the hypothesis annotation.

The output format for the block for a note can be customized. You can specify this format in your Roam Depot Settings. The template will replace NOTE for where the note text should appear and URL for where the URL to the hypothesis annotation.

The following commands will then be available to you.

Import Public Hypothesis Annotations

Looks at the text in the current block for a URL to an article. For that URL retrieves annotations from all users and inserts them as child blocks, with a limit of 20. The Smartblock Command equivalent is <%HYPOTHESISPUBLICANNOTATIONS%>, which takes in an optional limit parameter.

Import Private Hypothesis Annotations

Looks at the text in the current block for a URL to an article. For that URL retrieves "my" annotations and inserts them as child blocks, with a limit of 20. The Smartblock Command equivalent is <%HYPOTHESISINSERTANNOTATIONS%>, which takes in an optional limit parameter.

Open Site in Hypothesis

Looks at the text in the current block for a URL. It opens the URL in Hypothes.is for annotation. The Smartblock Command equivalent is <%HYPOTHESISOPENSITE%>.

Contributors

This extension is brought to you by RoamJS! If you are facing any issues reach out to support@roamjs.com or click on the chat button on the bottom right.

Other Extensions