Terminology
The URLs are constructed from a single command and optional parameters, with the following format:
x-devonthink://<command>?<parameter=value¶meter=value&...>
Note: The first parameter after the ID is always added after a question mark (?), additional ones after an ampersand (&), and any values must be percent-encoded.
Listed below are the commands and parameters available:
Commands:
createFormattedNote: Creates a formatted note.
createHTML: Creates a new HTML document.
createMarkdown: Creates a Markdown document.
createPDF: Creates a PDF.
createRTF: Creates a rich text document.
createWebArchive: Creates a web archive.
createBookmark: Creates a new bookmark.
Note: Use the location parameter set to a URL with the commands above to download the page in the specified format.
createGroup: Creates a group.
createText: Creates a new plain text document.
clip: Opens the Clip to DEVONthink panel.
note: Opens the Take Note panel.
search: Initiates a search in the open databases.
Parameters:
title: The title of the item to be created (string).
comment: A Comment to be added (string).
location: The URL linking to the content, e.g., the URL of the website for the bookmark (URL).
tags: Tags to be added (comma separated strings).
destination: The UUID of a group where the item shall be created (string).
source: The HTML content for HTML documents (string, only used by createHTML and createFormattedNotes).
text: The text content for text documents (string, used by createText and createMarkdown).
width: The page width (integer, only used by createPDF).
paginated: Paginate the created PDF (boolean, only used by createPDF).
hide: Hide and deactivate application after executing the comment (boolean).
noselector: Skip group selector (boolean).
query: The query to search for (string, only used by search).
reader: Post-process the page (integer, 0 = no post-processing, any other value = post-process).
referrer: The URL that referred to the item (URL).
selection: The selected text (string, only used by createRTF).
Example:
x-devonthink://createRTF?title=New%20bookmark&location=http%3A%2F%2Fwww.devontechnologies.com&noselector=1
Note: These are not x-callback-urls. An x-callback-url is a specific type of URL scheme that returns a value to the calling application.