Skip to content

Category: Liquid | Author

Liquid | Author User Guide

This is the release version of the user guide for Liquid | Author, incorporating Liquid | Flow (which is no longer a separate product).

Welcome To Liquid | Author

Author is a different kind of word processor with a minimalist work environment and powerful controls. Please have a look through this introduction to learn how to get the most out of Author:

Full Screen

Exit full screen and enter full screen view with the ESC key (normally you can only use the ESC key to exit full screen views).

Read/Edit Modes

Author features Read and Edit modes which are optimised for each type of activity. When you are in Read mode the text button says ‘Edit’ and when you are in Edit mode the button says ‘Done’. In Read mode Author behaves much like a text reader application, where you can do spacebar to go down a screen or select text and do spacebar for text-to-speech.
Toggle the modes with cmd/

Instant Outline

Pinch in on your trackpad to collapse the text to only see headings. You can then click on a heading to jump to that section or pinch back out or ESC to return to normal view.
Re-Order The Outline
If you are in Edit mode you can also click to the left of a heading and drag to re-order.  Assign Text As Heading
To assign a line of text as a Heading select the text and Ctrl-click on it and choose ‘Heading’ or use the keyboard shortcuts cmd-1 for level 1, cmd-2 for level 2 and so on.

‘Liquid’ Interactions

For advanced text interaction with the text in Author and all the text in your other macOS applications, use the Liquid utility:

To Use

To use, select the text and execute a keyboard shortcut (you will have to set this up yourself, see below). This will copy the text across into the Liquid bar. You can then choose a command; either through clicking in the menu or through using keyboard shortcuts such as ‘R’ for ‘References’ and then ‘W’ for ‘Wikipedia’.
It’s worth getting used to this since it will allow you to look anything up or do any of these operations in less than one second: •  Search Google, Google Images, Reverse Image Search, Google Maps & more•  References Wikipedia, IMDB, Etymonline, Google Definition & more•  Convert Currencies and other units: Area, Speed, Distance, Volume & more•  Translate over 100 languages•  Copy with Link, as Citation which will then be automatically recognised in Author & more•  Share via Email, Facebook, Twitter, Google Plus, WordPress & more

To Set The Keyboard Shortcut

To set the keyboard shortcut takes a minute because of macOS security:
1) Go to the System Preferences (under the Apple menu, top left on the screen) and click on the ‘Keyboard’ icon and then choose the ‘Shortcuts’ tab. 2) (IF you want to use cmd-space you will first need to disable that keyboard shortcut for Spotlight. You can do that by clicking on ’Spotlight’ in the column on the left and then giving Spotlight another shortcut or no shortcut.)3) Finally, in the column on the left click on ‘Services’ and then choose ‘Liquid’ in the column on the right, then assign your keyboard shortcut.
Liquid In Other macOS Applications
To launch Liquid you will need to launch/open Author (but you can quit Author and Liquid will keep running). If Liquid is not available choose ‘Liquid’ from the Help menu in Author).
You can also click on the horizontal Liquid bar in the macOS menu to enter text rather than launch it through selecting text and doing the keyboard shortcut.


Assigning Text To Be A Citation

To cite a reference; select the text you want to have cited then cmd-t. You can now choose; Manually (keyboard shortcut ‘enter’), Mendeley (keyboard shortcut ‘m’)  Amazon (keyboard shortcut ‘a’) or Web (if you copied As Citation using Liquid, as described above).

Once you have done so, whatever you had previously copied will be automatically added to the search dialog, which you can, of course over-write if it’s not what you are looking for. You will then be presented with a list of search results of which you can choose one and all the relevant information will be copied across to the Citation Dialog where you can also choose to add further information.

Video Citation via YouTube

Assigning a YouTube citation is a bit different but very very cool; You can choose to cite video from the exact time in the video when your citation is spoken, for example, Doug Engelbart talks about demonstrating his early prototypes (make sure you are in Read mode when you click on this to view the video and Edit mode to edit any details:

“…they never thought about just how quickly and flexibly you could do things…” (Engelbart, 2013)
To assign text with a YouTube citation go to YouTube and Ctrl-click in the video itself and choose ‘Copy URL from Current Location’. Switch to Author and select text and cmd-t as usual and choose ‘From YouTube’ (or hit ‘enter’) and fill in the ‘author’ field since the system does not know who is speaking in the video.

Search Document / Find

When you search with cmd-f and you have selected text, the document will instantly change to show only sentences which have the selected text in them. You can then click to jump to any of the occurrences shown or ESC or click in the margin to return to regular view


Share your documents as native Author documents or export them as .DOC or .RTF files which are accepted by most word processors: Choose ‘Export to…’ in the File menu. Documents will automatically have a References section at the end, where all Citations will be listed. The style can not be edited currently but we will be adding Citation Styles over time.


Thank you for being a pioneer Author user, I look forward to hearing from you. Please visit for more information or email me with any questions/comments/bugs/suggestions at

Frode Hegland
London 2017


Leave a Comment

Some of the issues

Some of the issues with the Liquid View come up when I use Scapple to simulate some of the aspects, for the work on my PhD.

Here I have created a column for the lifecycle or process to augment, which is linked vertically top down with arrows to indicate the general flow. To the right of this is a brief description of the point/goal of each process and there is then a divider/quit a bit of space before I get onto the invention/innovation/idea/development columns, the first one which is a list of specifically desired functionality which should be useful in make one or more processes reach the potential of the goal. This is followed by a column of what needs to be implemented for such functionality to be realised:

Issues which arise from this is that it’s clear that it would be useful for the nodes to be interactable to jump to specific sections of the main document, or external documents, but this is clearly not all the headings of a document, this is a subset of a document which means that it can be thought of as an inserted graph.

How this could be handled is if it is its own document and then embedded into the main document but this could become confusing, especially when the author want to link to a section in the main document from this view, which is not in this view…

This leads me to think the we should be stricture with hierarchy, not simply allowing the user to do everything arbitrarily. Maybe we make level 1 headings a special thing, which can only be viewed in a specific way? My friend Tom is an author and he showed me how he writes a chapter per word processing document and then collates them all at the end. This is a perspective to consider.

Having a look at this specific example above, let’s say that the four bold headings are level 1 headings and that what is shown below them are then level two and that’s all we have in this view, where the level 2 headings are ‘stuck’ under the level 1 headings in columns and the user connects any headings arbitrarily and can move them around. How would the user designate only these four level 1 headings for a Liquid View?

I must think of some way to allow the author to create multiple Liquid Views with different sets of headings – maybe there is a default one for the whole document and then a ‘process’ for creating a sub-set like this, with maybe a slightly different background colour and appearance in the main document?

A Solution?

A solution to this could be to have two completely different kinds of Liquid Views, maybe with two completely different designs and names:

  • Document Liquid View
  • Embedded Liquid View

The document Liquid View would work as previously discussed but the embedded Liquid View would be embedded in the same way as you might add a picture but the Liquid View created through embedding will only exist inside the host document, so it’s not so much embedded as created, but the term seems right.

Embedded / Liquid Diagram

There will be no headings in this Embedded Liquid View on creation but the user can ctrl-click on the screen to choose ‘Insert’ and a hierarchy of all the headings in the host document will appear, allowing the user to insert one heading as a node or a series, if there are any below the level chosen. This lets the headings be linked from the Liquid View into the main document. The user can also create headings from scratch and ctrl-click on them to link them to headings in the document.

The embedded Liquid View is not a Liquid ‘View’ then, it becomes a Liquid Diagram, since the user can click on a heading/node to jump to it in the document if it’s connected, but cannot ‘expand’ the view back into a word processing view since there is no such underlying structure. I will change the name of this in the future but for now I’ll leave it as it is here since this was the flow of thought as I went through it, writing this text.

This means that we can design different types of Embedded diagrams and visualisations.

Note also that the embedded is live, not an image.

Note to Jacob: We should probably develop a plugin architecture for the Embeds so that they can be developed and tested while integrated into he main document through links but built by different people for time saving.

Other documents can also be called into a link from an embedded diagram through relative or name addressing.

Leave a Comment

Basic Liquid | Reader, 09 Jun

The Liquid | Reader app is an iOS iPad Pro app for reading PDFs, highlighting sentences and viewing and searching the highlighted sentences later.

The idea is that a user can highlight text in a PDF on their iPad, then see and search all the highlighted text in a Document Listing view and they can easily copy the highlighted text to be automatically available as a citation in their word processor.

Document Listing

  • When the user opens the app, a view of documents exactly the same as the iOS 11 ‘Files’ application appears, with an important visual difference: Any PDF document which has been annotated in Liquid | Reader will show all annotated text under the document name, with a line break after each annotation.
  • In this view the user can pinch in and out to show or hide this annotation text, in the same way that the user can pinch to show and hide body text in Liquid | Author.
  • The Search field at the top of the screen features a toggle to Search All/Annotations Only (iOS interface standard to the right of the dialogue).
  • To the right of each citation text, where the ‘download from iCloud’ icon is for the document, there is also an iOS Share icon. Tap on this to get the option to Copy (the annotated text) As Citation. This uses the same format as Copy as Citation from Liquid | Flow to Liquid | Author uses, with information about the document author included, if this was created/added during the opening of the document. With modern iOS and macOS this then allows the user to tap this option and then Paste on their Mac, and if they use Liquid | Author all the citation information comes along.

Document View

  • The document view has no visible interface elements. Going from one page to another is the same action as in iBooks (no animation though, just swipe right and left).
  • The user can use an Apple Pencil to highlight text (stripe draw over it and it’s highlighted, just like using an analog pencil – no need to highlight and then choose ‘Highlight’ in a menu, the text is simply drawn on and highlighted). This highlighted text is what appears under the document name in the Document Listing view and is what needs to be searchable in that view.
  • To un-highlight draw over the text again.
  • To exit the reading mode and return to the Document Listing pinch out.

Development Notes


Version 2


  • When the user opens a document (by tapping on it) the system opens the PDF and if it’s the first time it’s been opened it asks the user to highlight the name of the document (Dialogue: ‘Please select the title of this document’ [Ignore] [OK]), which should be on the first page. Once done, the system presents a dialogue presenting the user with the Author’s name and publication date (as retrieved from Mendeley, see below). This is then used to re-name the document and to create a basic About/’Get Info’ record of the document for later use. The way this happens is that the app searches Mendeley based on the document name and auto-completes a dialog which is called ‘About this Document’ and which is identical with the Citation dialogue in Author.


  • Pinch out to only see annotations in the document. This does not interfere with the pinch out to close the document, as that would be another level of pinch out.
  • When a document is open the user can select text and get a black iOS menu with the same Search and References menu as Liquid | Author in Read Mode.
  • To exit the reading mode and return to the Document Listing pinch out.