Previous: , Up: Roam Protocol   [Contents]

12.4 The ‘roam-ref’ Protocol

This protocol finds or creates a new note with a given roam_key (see Anatomy of an Org-roam File):


To use this, create the following bookmarklet in your browser:

javascript:location.href =
+ encodeURIComponent(location.href)
+ '&title='
+ encodeURIComponent(document.title)

or as a keybinding in qutebrowser in , using the file (see Configuring qutebrowser):

config.bind("<Ctrl-r>", "open javascript:location.href='org-protocol://roam-ref?template=r&ref='+encodeURIComponent(location.href)+'&title='+encodeURIComponent(document.title)")

where template is the template key for a template in org-roam-capture-ref-templates (see The Templating System). These templates should contain a #+roam_key: ${ref} in it.