Shortcuts FAQ

Frequently asked questions about Shortcuts.

How can I use Apple Shortcuts?

A shortcut is a quick way to get one or more tasks done with your apps. The Apple Shortcuts app lets you create your own shortcuts with multiple steps.

Articles + includes shortcuts to bookmark, list articles or annotations and export them in text, markdown or json format. All actions are available directly in the Apple Shortcuts app with iOS 16+ and can be freely combined with other ones.

Shortcuts
Bookmark Bookmark article for reading later.
Find Article List all articles or filter by properties (date, title, tags, ...).
Export Article Save article metadata in text, markdown or json format.
Find Annotation List all annotations or filter by properties (date, tags, ...).
Export Annotation Save annotation metadata in text, markdown or json format.

How can I use Shortcuts to bookmark articles?

The Bookmark shortcut allows to save an article for reading later. This action requires a url for input, that can be entered when running the shortcut or set from a variable of a previous step.

Bookmark article (example)

  1. Add Bookmark shortcut
  2. Set url or run to input a link

How can I use Shortcuts to export articles?

Individual articles can be exported in text, markdown or json format with the Export Article shortcut. When using the Find Article shortcut, you can also get a filtered list of articles to automate saving metadata and annotations of all your bookmarks.

Export article (example)

  1. Add Export Article shortcut
  2. Choose a format (text, markdown, json)
  3. Choose one or run to select from latest

Export all articles (example)

  1. Add Find Article shortcut
  2. Optional: Add Filter (date, title, tag, ...)
  3. Add Repeat with Each action after list output
  4. Add Export Article shortcut for Repeat Item inside the loop
  5. Use the Files app Save File action to save the export to e.g. iCloud Drive

Please note that exporting all articles currently only works on iPad 16.1 beta but somehow not anymore on the latest iOS 16. Most likely this is an issue in Apple's Shortcuts app ¯\_(ツ)_/¯

How can I use Shortcuts to export annotations?

You can export selected annotations in text, markdown or json format with the Export Annotation shortcut. The Find Annotation shortcut lets you get a filtered list of annotations that can be used to for example synchronize your notes and highlights with external services like Readwise.

Export annotation (example)

  1. Add Export Annotation shortcut
  2. Choose a format (text, markdown, json)
  3. Choose one or run to select from latest

Export all annotations (example)

  1. Add Find Annotation shortcut
  2. Optional: Add Filter (date, title, tag, ...)
  3. Add Repeat with Each action after list output
  4. Add Dictionary and set properties from Repeat Item inside the loop
  5. Create new Dictionary action to save the export output in the required format

How you structure or upload the exported json depends on the format of a service. See the corresponding documentation to find out more:
https://readwise.io/api_deets

Where can I find more information about Shortcuts?

For other questions or more details about Shortcuts, please refer to Apple's official documentation and support.

Shortcuts User Guide:
https://support.apple.com/en-us/guide/shortcuts