How to create Custom Actions in Goodlinks

I love Goodlinks as my read-it-later app. Even though I love it and think that its the best reading experience of all read-it-later apps I've still been using Instapaper for its Share All Notes feature. Since I would like to use Goodlinks exclusively, I started wondering if I could replicate this feature with a Goodlinks Custom Action.

The first thing that I had to do was learn how to create a custom action. A google search found nothing on the subject. So I reached out to Ngoc Luu the developer of Goodlinks and he was a great help. I'm going to share our email conversation with you.

Ngoc Lou:

The sample action in my previous email is not correct, the ‘+’ character should be changed to ‘%0A’ to create newlines. ‘%0A’ is URL-encoded form of a new line character.

Here is an update of the your Drafts action that will place title, author and link URL in separate lines:


You can format the values in Markdown by inserting Markdown format characters in the URL:

drafts://create?text=# [title]%0A_[author]_%0A[url]

But this URL will not work because it contains unsafe and reserved characters (whitespace, #), you will need to URL encode them (same as %0A above), so the correct URL should be:


GoodLinks already supports a special syntax to URL encode text, it is { }. The text enclosed in those brackets will be URL encoded. You can use them in the URL like this:

drafts://create?text={# }[title]%0A{*}[author]{*}%0A[url]

It is easier to understand and edit. The underscore character is safe, but it is better to URL encode all text (excluding values, e.g: [title], [url]...) in the URL parameter.

After updating an action, you might need to restart the app in order for the changes to take effect. This is a bug and will be fixed in the next update.

Now that I understand how to create a custom action, I created the following actions to get content into Drafts. There's also one for creating a todo in Things.

Markdown Title and URL to Drafts


Title and URL to Drafts

drafts://create?text={# }[title]%0A{_}%0A[url]

Title, Author, and URL to Drafts

drafts://create?text={# }[title]%0A{*}[author]{*}%0A[url]

Title, Author, URL, and Summary to Drafts

drafts://create?text={# }[title]%0A{*}[author]{*}%0A[url]%0A[summary]

Title and URL to Things 3


I'm reasonably sure these actions are going to make Goodlinks my only read-it-later app.

This post appeared first on

Have something to say? Send me an email.

Found this post useful? Why not buy me a coffee?

RSS | | Mastodon | Medium
© 2023