OmniOutliner is an outliner developed by The Omni Group.
OmniOutliner is a powerful tool for organizing (and reorganizing) information, so you can see the full picture and structure your information effortlessly.
Hookmark enables you to link OmniOutliner documents to and from anything that is also link-friendly.
This page provides some of the technical details about linking with OmniOutliner.
Copy Link and Copy Markdown Link commands
When you invoke Hookmark on a document in OmniOutliner and then choose
Copy Link or
Copy Markdown Link, Hookmark will produce a link containing a URL like this:
hook://file/. You can paste those links anywhere.
These links are robust, meaning you can move the OmniOutliner document around and the link will still work! In addition, if you’ve selected a row when copying a link using Hookmark, the link will be deep, pointing to a specific row in the document.
Hook to Copied Link
Hookmark enables you to create 2-way links between OmniOutliner documents and any other link-friendly object. We call these links “hooks”.
Here’s one way to create hooks. Use Hookmark to copy a link to an OmniOutliner document in the clipboard (as explained in the prior section). Then navigate to another item, invoke Hookmark, and use the handy
Hook to Copied Link command. The
Hook to Copied Link command is available in Hookmark’s contextual window (Title bar button, in the Action ☰ button, or via the ⌘V keyboard shortcut). You can also access the
Hook to Copied Link command by control-clicking on another file in the Finder (assuming you’ve installed Hookmark’s Finder extension.)
See Hook to Copied Link for more information.
Deep linking to specific rows in OmniOutliner documents!
You may be familiar with OmniOutliner’s
Copy Link function. When you select a row in an OmniOutliner document and use this OmniOutliner command, you get a link, like this:
omnioutliner:///open?row=lAgiZr2AgMn. These links are great because they bring you to the specific row in the document. But they only work if the document from which the link was copied is currently open.
Hookmark extends OmniOutliner’s deep linking functionality, enabling you to create deep links that
- do not require the file to be open,
- are robust, meaning the links continue to work even if you move the files around!
As long as a row is selected, text in a row is selected, or the cursor is in a row, Hookmark’s
Copy Link returns a deep link. Deep links have a
rowid parameter in their address that matches the native OmniOutliner link. Here is an example. If you inspect that link you’ll see that Hookmark has embedded
rowid=lAgiZr2AgMn in the URL. (That’s the row ID provided by OmniOutliner that we mentioned above.)
Deep links are very convenient for long and deep outlines. This functionality is emblematic of Hookmark, which helps you focus your attention to the precise information you need without you needing to search.
Copy Selection and Link
If you select text within a row, then Hookmark enables the
Copy Selection and Link ⌃Q menu item. This command
- copies the selected text,
- adds a new line to the clipboard, and
- copies a deep link to the item.
See Copy Selection and Link for more about this command.
Hook to New > OmniOutliner
Hookmark enables you to instantly create new OmniOutliner documents and link them to the current item, whether a web page, email, PDF , file, project, etc., in any such context.
Hook to New command, you can instantly create a new OmniOutliner item linked to the current item, whether it be a web page, email, PDF, file, project, etc..
For example, if you invoke Hookmark on the current web page,
Hook to New(⇧⌘N),
- select OmniOutliner, and
- hit the return key:
- create a new OmniOutliner document,
- name the document according to this web page,
- hook (bidirectionally link) this web page to the new OmniOutliner document, and
- add a bookmark inside Hookmark to this webpage and to the new OmniOutliner document.
Not bad, for one quick command.
You can also make OmniOutliner your default
Hook to New (“note-taking”) app in Hookmark’s Notes preferences pane. In that case, instead of using
Hook to New... (⇧⌘N), you can simply invoke Hookmark and then use ⌘N; or even faster, use Hookmark’s global shortcut for creating new notes.
Hook to new entire OmniOutliner folders!
Hookmark also enables you to use
Hook to New to create an entire interlinked folder based on a template. We have created a special folder just for OmniOutliner users.. Click that link to download the template folder. The template contains folders, OmniOutliner files and an OmniGraffle file:
- Communications, reviews, comments, etc. (folder)
- Drafts (folder)
- Figures (folder)
- Hookmark (.hook) files (folder)
- Previous (folder)
- Resources and Research (folder)
- Reviews and comments about this from others
For more information, see Templates – Hookmark.
Reveal File in Finder
Suppose you are editing an OmniOutliner file and you want to see where it is located on the Finder. Hookmark has you covered. Simply invoke Hookmark, click the Action ☰ button, and select Reveal File in Finder.
Search for OmniOutliner bookmarks in Hookmark
Hookmark automatically bookmarks links it creates. That means if you use Hookmark to copy links to OmniOutliner documents or hook them to anything, then Hookmark will automatically bookmark those items for you. Later you can find those bookmarks using Hookmark’s search on any Mach with which you sync Hookmark’s bookmarks! Hookmark becomes a treasure trove of links to the information you value the most.
To find OmniOutliner items you’ve processed with Hookmark, simply
- invoke Hookmark
- enter search mode (with ⌘F or a click)
ooutlineand hit the return key
Your OmniOutliner bookmarks will show up in the search results.
OmniOutliner is discussed and illustrated elsewhere on this website. To find out more:
- Click the search icon in the top right corner of the website and search for “OmniOutliner” there,
- Search for “OmniOutliner” on the Hookmark Forum