# Retrieve annotations for Hypothes.is via Templater plugin (Hypothes.idian) **URL:** \ **Category:** Plugins\ **Tags:** plugin-release\ **Created:** [April 26, 2021, 1:48pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225 "2021-04-26T13:48:07Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![TfTHacker](https://forum.obsidian.md/user_avatar/forum.obsidian.md/tfthacker/32/12958_2.png) [@TfTHacker](https://forum.obsidian.md/u/TfTHacker)\ **Post date:** [April 26, 2021, 1:48pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/1 "2021-04-26T13:48:07Z")
I use [https://hypothes.is/](https://hypothes.is/) to annotate web sites and web based pdf’s. I want to easily import them into Obsidian. This script uses the Templater template. Template File: [Templater script hosted on GIST GitHub](https://gist.github.com/tfthacker/c48bca69f1520deed0ecbc8840f6241a) Script in action: [![](https://img.youtube.com/vi/f-mVj_DSaag/maxresdefault.jpg "hypothes.idian Demo for Obsidian") ](https://www.youtube.com/watch?v=f-mVj_DSaag) It is ready for testing. Feedback welcome. ---
**Author:** ![Daniyal-Ahmed](https://forum.obsidian.md/user_avatar/forum.obsidian.md/daniyal-ahmed/32/8128_2.png) [@Daniyal-Ahmed](https://forum.obsidian.md/u/Daniyal-Ahmed)\ **Post date:** [April 26, 2021, 5:07pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/2 "2021-04-26T17:07:32Z")
I’ve never used the Templater Plugin, But can you tell me how to achieve what you are doing in the video. I’ve done the following; 1. Made the Hypothesis config.md file with only my token inside, it’s in my vault. 2. I’ve made a note in my templates folder named Hypothesis, basically it is the note where I copy pasted the GIST you provided 3. I’ve edited the gist to have my token where it’s written UserToken and my Hypothes.is account name where it says UserId. **Now I just want to achieve what you are doing in the video. What additional steps are required? Or am I missing some basic Keyboard shortcuts.** ---
**Author:** ![Erisred](https://forum.obsidian.md/user_avatar/forum.obsidian.md/erisred/32/6273_2.png) [@Erisred](https://forum.obsidian.md/u/Erisred)\ **Post date:** [April 26, 2021, 5:37pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/3 "2021-04-26T17:37:50Z")
I’m very interested in this as well, however I’ve never had occasion to work with Gists. Would you be willing to more specifically explain what to do with the code and files? I tried the same thing as @Daniyal-Ahmed with no success. I suspect I need to “run” the gist somehow. Thanks in advance! ---
**Author:** ![TfTHacker](https://forum.obsidian.md/user_avatar/forum.obsidian.md/tfthacker/32/12958_2.png) [@TfTHacker](https://forum.obsidian.md/u/TfTHacker)\ **Post date:** [April 26, 2021, 6:57pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/4 "2021-04-26T18:57:40Z")
Install steps: 1. Install Templater plugin in Obsidian 2. Configure your templates folder in the templater settings page in “settings” 3. Copy the text in the gist to a file in your templates folder for templater 4. Now you can run that script (press ALT+E) and select the script you copied in. 5. The first time it runs, it creates they Hyposthesis config.md file for you with all the settings you need. After that run the script and select the command you want. ---
**Author:** ![TfTHacker](https://forum.obsidian.md/user_avatar/forum.obsidian.md/tfthacker/32/12958_2.png) [@TfTHacker](https://forum.obsidian.md/u/TfTHacker)\ **Post date:** [April 26, 2021, 6:59pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/5 "2021-04-26T18:59:19Z")
Please see my other post to this thread with install steps. GIST is just a way to store files on the web and share them. Go to the gist page in the link, click on the “RAW” button, which shows you all the text you need and copy that a file in the templater templates folder. ---
**Author:** ![Erisred](https://forum.obsidian.md/user_avatar/forum.obsidian.md/erisred/32/6273_2.png) [@Erisred](https://forum.obsidian.md/u/Erisred)\ **Post date:** [April 26, 2021, 7:20pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/6 "2021-04-26T19:20:11Z")
I didn’t realize using the template would “activate” the code. That’s what I needed to get it working. I obviously haven’t tested much yet but if I find issues, I’ll let you know. This is absolutely fantastic. Thanks so much for sharing! ---
**Author:** ![TfTHacker](https://forum.obsidian.md/user_avatar/forum.obsidian.md/tfthacker/32/12958_2.png) [@TfTHacker](https://forum.obsidian.md/u/TfTHacker)\ **Post date:** [April 26, 2021, 7:27pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/7 "2021-04-26T19:27:43Z")
my pleasure. sorry i am new to templater as well. It is running the code in the file. lots happening there 🙂 ---
**Author:** ![Daniyal-Ahmed](https://forum.obsidian.md/user_avatar/forum.obsidian.md/daniyal-ahmed/32/8128_2.png) [@Daniyal-Ahmed](https://forum.obsidian.md/u/Daniyal-Ahmed)\ **Post date:** [April 27, 2021, 5:07am UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/8 "2021-04-27T05:07:51Z")
Ok, That’s How it’s done. Thank You @TfTHacker, for writing this script. It is very useful to annotate while you are reading something on the web and then Export it into Obsidian later. This way we don’t need to move back and forth from Obsidian and Browser to write notes. ---
**Author:** ![Christian](https://forum.obsidian.md/user_avatar/forum.obsidian.md/christian/32/10431_2.png) [@Christian](https://forum.obsidian.md/u/Christian)\ **Post date:** [April 27, 2021, 12:49pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/9 "2021-04-27T12:49:44Z")
This is a great Templater script. Thanks, @TfTHacker. ---
**Author:** ![TfTHacker](https://forum.obsidian.md/user_avatar/forum.obsidian.md/tfthacker/32/12958_2.png) [@TfTHacker](https://forum.obsidian.md/u/TfTHacker)\ **Post date:** [May 4, 2021, 11:10am UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/10 "2021-05-04T11:10:17Z")
Hey peeps, fixed a bug today that the config file generated by this script can be stored any where in your graph, not just in the root folder. ---
**Author:** ![Erisred](https://forum.obsidian.md/user_avatar/forum.obsidian.md/erisred/32/6273_2.png) [@Erisred](https://forum.obsidian.md/u/Erisred)\ **Post date:** [May 4, 2021, 1:12pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/11 "2021-05-04T13:12:46Z")
Great addition. I can’t say having it in root was _bad_, but it’s nice to tuck it away. Thanks again for the script. I plan to wean myself off Zotero for those times when I don’t need a full blown reference. ---
**Author:** ![chrisaldrich](https://forum.obsidian.md/user_avatar/forum.obsidian.md/chrisaldrich/32/3657_2.png) [@chrisaldrich](https://forum.obsidian.md/u/chrisaldrich)\ **Post date:** [July 9, 2021, 12:12am UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/12 "2021-07-09T00:12:27Z")
I’ve modified a portion of the template to better suit my own use. I’ve posted [a Gist of my version](https://gist.github.com/chrisaldrich/031c946446b1bc070b1937f330989c63) for those who’d prefer it or would like an alternate example of an modification of the template section. Perhaps it may help those who are not as code-savvy puzzle out how they might make their own modifications? The changes still keep all the relevant data fields, but reorder them and add a bit of formatting to fit the layout and the way I use my Obsidian notebook. In particular, I changed the formatting so that tags in Hypothes.is are turned into [[wikilinks]] rather than #⁠hashtags as in the original. (The original also doesn’t do so well with multi-word tags in Hypothes.is, which I use quite a lot.) ---
**Author:** ![davidrsim](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/d/3e96dc/32.png) [@davidrsim](https://forum.obsidian.md/u/davidrsim)\ **Post date:** [July 9, 2021, 3:30pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/13 "2021-07-09T15:30:47Z")
This is amazing. I didn’t know about Hypothes.is, despite having tried a few of its “competitors”. I’m looking forward to playing with it and to have such an easy link to Obsidian will almost certainly make this my “go to” tool. Thank you for your efforts. The only issue I’ve found with this plugin is if I have annotations on a local PDF file (using Chrome and the Chrome Hypothes.is extension). It crashes. Remove any local PDF annotations and it works again. I’ve not been able to parse the JSON from Hypothes.is yet to see what is fundamentally different. Not a biggie for me - I generally host PDFs on the cloud - but just thought I’d mention. Edit: Main difference seems to be the URI/Source which is a fingerprint of the local PDF: e.g. “uri”: “urn:x-pdf:a999faa94eb5eb4efefee1f1e1b519482” ---
**Author:** ![nat](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/n/8c91f0/32.png) [@nat](https://forum.obsidian.md/u/nat)\ **Post date:** [July 28, 2021, 2:49pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/14 "2021-07-28T14:49:53Z")
This is beyond amazing! Thank you so much. ---
**Author:** ![Expeditioner](https://forum.obsidian.md/user_avatar/forum.obsidian.md/expeditioner/32/29267_2.png) [@Expeditioner](https://forum.obsidian.md/u/Expeditioner)\ **Post date:** [August 8, 2021, 7:03am UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/15 "2021-08-08T07:03:06Z")
Can we sort by tags ? ---
**Author:** ![FREDDAY1522](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/f/e9c0ed/32.png) [@FREDDAY1522](https://forum.obsidian.md/u/FREDDAY1522)\ **Post date:** [October 2, 2021, 9:23pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/16 "2021-10-02T21:23:14Z")
This is a great process. It would be good to include the step by step in your post and/or in the video. As a newbie to Obsidian and Mark Down, these help my note processing go much faster. Just wanted to say thank you! ---
**Author:** ![cadall36](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/c/a88e4f/32.png) [@cadall36](https://forum.obsidian.md/u/cadall36)\ **Post date:** [October 21, 2021, 5:56pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/17 "2021-10-21T17:56:52Z")
Hi David, I wanted to ask what cloud solutions one can use to achieve something like getting a raw PDF display in the browser. I am using OneDrive, but I don’t think it redirects you to / give you a raw pdf link in any way. Thanks in advance ---
**Author:** ![Wen](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/w/f9ae1b/32.png) [@Wen](https://forum.obsidian.md/u/Wen)\ **Post date:** [October 22, 2021, 7:34pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/18 "2021-10-22T19:34:17Z")
There is also a plugin for this now: [weichenw/obsidian-hypothesis-plugin: An Obsidian.md plugin that syncs highlights from Hypothesis.](https://github.com/weichenw/obsidian-hypothesis-plugin) ---
**Author:** ![pupka12](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/p/ecc23a/32.png) [@pupka12](https://forum.obsidian.md/u/pupka12)\ **Post date:** [December 19, 2021, 5:33pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/19 "2021-12-19T17:33:58Z")
Does anyone know a way to do this with my annotations on locally stored pdfs? That would be lovely. I know I could probably move them to some cloud, but I have no idea which one could work (the most popular ones seem not to) ---
**Author:** ![Wen](https://forum.obsidian.md/letter_avatar_proxy/v4/letter/w/f9ae1b/32.png) [@Wen](https://forum.obsidian.md/u/Wen)\ **Post date:** [December 20, 2021, 6:30pm UTC](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225/20 "2021-12-20T18:30:35Z")
If you use Zotero, the following workflow may be of interest: > [@Zotero -\> zotfile -\> mdnotes -\> obsidian -\> dataview Workflow](https://forum.obsidian.md/t/zotero-zotfile-mdnotes-obsidian-dataview-workflow/15536): > > This is a workfrow about setting up a smooth(ish) transition from getting a pdf into [zotero](https://www.zotero.org/) (which is a reference manager), annotating it, extracting annotations (with or without color coding for that), pushing those into Obsidian using the [@argentum’s mdnotes plugin](https://github.com/argenos/zotero-mdnotes) - specifically, the latest alppha release at the time of this post: [0.2.0 alpha4](https://github.com/argenos/zotero-mdnotes/releases) and have those readily usable with [Michael Brenan’s Dataview plugin](https://github.com/blacksmithgu/obsidian-dataview). 2023 Update: there is a new plugin, the [Zotero Integration plugin](https://github.com/mgmeyers/obsidian-zotero-integration), that works wel… If you are on the macOS, PDF readers like PDF Expert can also extract highlights as Markdown: > **[PDF Editor and Reader for Mac | Free Trial | PDF Expert](https://pdfexpert.com/)** > > Download a free trial of PDF Expert – the best PDF software for your Mac. Enjoy advanced reading layouts, powerful PDF editing and classical annotation tools. If you are on the macOS and uses [Alfred - Productivity App for macOS](https://www.alfredapp.com/), the following workflow can also extract annotations: > **[GitHub - chrisgrieser/pdf-annotation-extractor-alfred: Alfred Workflow to...](https://github.com/chrisgrieser/pdf-annotation-extractor-alfred)** > > Alfred Workflow to extract annotations from PDF files. - chrisgrieser/pdf-annotation-extractor-alfred [Next page](https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225.md?page=2)