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):

images/roam-ref

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

javascript:location.href =
'org-protocol://roam-ref?template=r&ref='
+ encodeURIComponent(location.href)
+ '&title='
+ encodeURIComponent(document.title)

or as a keybinding in qutebrowser in , using the config.py 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.