Using Hook with Obsidian

Last updated 2021-05-27 15:35

Hook Integration scripts version 139 introduced support for the Obsidian note-taking app. We’ve been tweaking the support since then. And Obsidian plans to add additional support to which we expect to adapt Hook.

This means you can now link your Obsidian notes to just about anything.

We are grateful to Josh Nichols and Lisa Sieverts for this integration. (See below.)

Currently supported functions

The current integration of Hook with Obsidian makes use of obsidian:// links. It supports:

  • Copy Link in Obsidian
  • Copy Markdown Link in Obsidian
  • Copy All Links in Obsidian
  • Hook to Copied Link in Obsidian

and related functionality (e.g., find and Hook window navigation).

Limitations of Obsidian integration and planned functionality

Please note that Obsidian is still in pre 1.0 beta. Hence the following limitations.

If only one Obsidian vault is open, Copy Link and Copy Markdown Link copy a link to the currently open document. However, if more than one vault is open, Hook will obtain a link to the document that was mostly recently opened, which may or may not be the frontmost open document. More precisely when there is at least one open document, this always returns a link to the “most recently opened document”; this is equal to the “currently document” if there is only one vault open, otherwise it may or may not be. This limitation is because Obsidian does not yet provide an API to copy the link to the frontmost document. Our integration script therefore uses a heuristic.

As of 2021-05-27, obsidian URLs are not robust, meaning that if you move obsidian files, their URLs will break. This is a matter to be taken up with the Obsidian devs. As noted, Hook’s Copy Link and Copy Markdown Link in context obsidian returns obsidian:// URLs, not hook://file/ links. obsidian:// URLs currently code a relative path of the file (relative to the vault).

We plan to support the following in Obsidian too when the Obsidian API matures.

  • Hook to New (Not yet supported because Obsidian does not have an API for this either. However, the Obsidian dev have indicated they will provide a solution for this).
  • Reveal File in Finder
  • hook://file/ URLs

If you immediately require an app that is fully linkable without those limitations, please consult this list of apps.

How is Obsidian relevant to Hook users

What is the Obsidian app?

Obsidian is an Electron note-taking app, hence with the same “look & feel”, on multiple platforms ( Windows, Linux (AppImage), Linux (Snap), and Linux (Flatpak) and macOS.

Per its home page Obsidian (2020-12-08), Obsidian is

a powerful knowledge base that works on top of a local folder of plain text Markdown files.

The Obsidian Features page (2020-12-08) boasts:


We want your second brain to work like a real brain, so Obsidian encourages you to make connections between your notes. Simply type [[ and Obsidian will auto-complete the link.

With connections in place, you can navigate your notes and get inspiration with backlinks and graph view.


We at CogSci Apps Corp. would like to thank Lisa Sieverts for being a liaison between CogSci Apps and the Obsidian community.

We wish to thank Josh Nichols for publishing JavaScript on which Hook’s integration is based.

Josh is known as technicalpickles on Github and on Obsidian’s Forum and @techpickles on Twitter.

Thanks also to many Hook Productivity Forum members who contributed to this discussion .

Hook Productivity App Newsletter

Sign-up to receive emails about Hook productivity app. Our emails sometimes include coupons for discounts on great Hook-linkable apps made by other developers.

 Marketing permission: I give my consent to to be in touch with me via email using the information I have provided in this form for the purpose of news, updates and marketing.

What to expect: If you wish to withdraw your consent and stop hearing from us, simply click the unsubscribe link at the bottom of every email we send or contact us at We value and respect your personal data and privacy. To view our privacy policy, please visit our website. By submitting this form, you agree that we may process your information in accordance with these terms.