Hi there
How can I use URLs in DT3 on the Mac to add Markdown documents?
Via the Drafts app I tried
x-devonthink://createMarkdown?title=[[title]]&location=''&text=[[body]]
In DT3 I get instead of a Markdown document an empty entry of kind “internet location”. From my understanding the same URL works correctly on iOS.
What do I (or Drafts) do wrong?
Thanks for any pointers.
X-callback URLs on the Mac are very limited and basically only intended for clipping (e.g. bookmarklets). AppleScript & smart rules are recommended for automation usually. Anyway, could you please post the complete URL you tried?
X-callback URLs for moving DRAFTS 5 documents on a Mac to DT3 is definitely not going to work for you.
There are two pretty easy means of adding a DRAFTS 5 document to DT3.
[1] Using the new Sorter
x-devonthink://note?title=[[title]]&text=[[line|2..]]&tags=[[tags]]
This single step action (URL using this template) will open the DT3 Notetaker
The parameters are filled in automatically based on whatever is the foremost / presented draft on which the action is invoked.
The body of the drafts is automatically filled in correctly (and, of course, you have the option of editing the content before sending it into DT3)
The title of the DT3 file is exactly that of the draft.
Any tags associcated with the originating draft are added to the document that gets saved in DT3.
You have the choice of format (plain text, rich text, formatted, or markdown)
You have the choice of location (database and group) in which the resulting document is stored.
[2] Targeted Group
x-devonthink://createMarkdown?title=[[title]]&text=[[body]]&tags=[[tags]]&destination=9E54D865-BF18-4ECD-AF04-802BFE34AC13-17033-00000BDBA96C975F
This single step action in DRAFTS will take the foremost draft and send it to a specific group within a specific DT3 database. To obtain the UUID of the target group, within DT3 by copying the item link of the target group, which will place in your clipboard something like this.
x-devonthink-item://9E54D865-BF18-4ECD-AF04-802BFE34AC13-17033-00000BDBA96C975F
The UUID is the alphanumeric string that follows the double slash. Copy that into the URL above. This URL works very well, and can be incorporated into a more complex action script in which you’ve created a list of Groups to which you want to save drafts on a regular basis.
1 Like
Thanks for the replies!
@cgrunenberg An actual sample URL is:
x-devonthink://createmarkdown?title=Lewis%20Fry%20Richardson%20-%20Interesting%20scientist&location=%27%27&text=Lewis%20Fry%20Richardson%20-%20Interesting%20scientist%0A%0A%2A%20Weather%20predictions%20%0A%2A%20Source%3A%20Smith%20Journal%20Spring%2019
On iOS I get in the Inbox a Markdown document with title Lewis Fry Richardson - Interesting scientist and content
Lewis Fry Richardson - Interesting scientist
* Weather predictions
* Source: Smith Journal Spring 19
I was hoping to get the same on macOS in DT3…
PS for @rmiller7: I don’t need the sorter I just want to send the stuff to the Global inbox. Do I really have to set an explicit location/destination for this?
The location
parameter is invalid, the link works as expected after removing it.
Thanks a lot @cgrunenberg - this exactly was problem!
I’ll try whether the URL without the location parameter works on iOS as well - which would be terrific!
The location
parameter is optional.
As noted in the documentation (and it is in both DEVONthink and DEVONthink To Go’s), the location
is an associated URL for the file, e.g., adding https://www.devontechnologies.com
as a location for the user manual you imported.
@BLUEFROG The location parameter might be optional, but when it is set on macOS like this:
x-devonthink://createmarkdown?title=Lewis%20Fry%20Richardson%20-%20Interesting%20scientist&location=%27%27&text=Lewis%20Fry%20Richardson%20-%20Interesting%20scientist%0A%0A%2A%20Weather%20predictions%20%0A%2A%20Source%3A%20Smith%20Journal%20Spring%2019
it does not give a proper Markdown document with the location set to ‘’. Try it!
@cgrunenberg and all: Anyway my problem is solved: When I get rid of the location
parameter the action works on both macOS and iOS like a charm.
I didn’t mean you can set it to a null value. It must be set to some valid value.
It’s optional as in, don’t include it unless it’s needed.
@cgrunenberg
If a location
parameter is included, it will download content from the specified URL as the text of the generated file.
x-devonthink://createMarkdown?title=Testing&ttext=This%20is%20a%20Markdown%20document.&location=https%3A%2F%2Fwww.devontechnologies.com
yields this, noting the URL is applied but the text is ignored…
Ooooooooooooooh, I see! The location
is used to download the content, not just to set the URL field of the document! Then it makes sense that location='
’ does not work!
Thanks for the (patient!) clarification.
By default it’s the bookmarklet to capture Markdown, only without a location and by specifying the text a Markdown document can be directly created.