Using Hook with the Craft Mac Writing App

NB: This integration currently requires macOS Big Sur, as noted below. Please make sure you have the latest Hook integration scripts (version 165 or newer) in Hook > About (or its Update tab). You may need to do Hook > Preferences > Update > “Check Now”. That will update the integration with Craft (if is not up-to-date.)

Craft is a relative newcomer to the world of note-taking, writing and document-creation apps, but its beautiful UI and rich feature set have led many Mac users to adopt it. Its developer clearly values integration with other apps and services, and has growing support for automation of these integrations – allowing you to stay “in flow” while you’re working in Craft.

From its first release, Craft has supported bidirectional linking and backlinks. In addition to allowing users to copy a link to any page, its Copy Deeplink and Copy Markdown Deeplink features let you copy links to blocks, cards or sub-pages within documents.

Hook enables you to bidirectionally link Craft pages, blocks, cards or sub-pages to just about anything else on your Mac, including other files and folders throughout your system. They are connected via a hook – a bidirectional link that is visible whenever you invoke Hook on either item in the link.

You can also paste links obtained through Hook into Craft to connect files, folders, emails, tasks, contacts cards and other resources to your Craft documents.

How to copy links in Craft for use with Hook (Copy Link and Copy Markdown Link)

There are two ways to copy a link from Craft. With either method, have your Craft document open and the window selected. Then, either:

  1. Invoke Hook in your preferred manner, then press ⌘C or choose Copy Link or Copy Markdown Link from the menu, as shown below. This will copy the link to the current Craft document. OR
  2. Use Craft’s own link copying capabilities, by selecting or placing your cursor in any Craft block and either using File menu > Copy Deeplink (or File menu > Copy Markdown Deeplink) or ⌘/Right Click and choosing Copy Deeplink (or Copy Markdown Deeplink) from the contextual menu.

screenshot 2021-03-01 at 4.27.24 PM.jpg

The first option will allow you to copy the link to the current Craft page and its name; the second option will copy a deeplink to the Craft block.

Deeplinks resulting from Craft’s Copy Markdown Deeplink will be named after the title in Craft, while those resulting from its Copy Deeplink command will be named after the URL returned by Craft. Once you’ve hooked a deep link to another item, you can click on the Hook menu next to the link and select Rename if you like. This works for any link you’ve used in Hook.

Hook Craft links to anything you want

Hooking a Craft document to anything is easy. Once you’ve copied a Craft link using either of the above methods, just:

  1. Select the item (file, folder, email, task or other) to which you want to attach a copied Craft link.
  2. Invoke Hook.
  3. Select Hook to Copied Link or hit ⌘V

Now, your copied link to Craft will show up whenever you invoke Hook while the file or folder is selected. Just click the link to open Craft directly to that document or block.

Using Hook’s Hook to Copied Link feature, you can attach multiple Craft links and deeplinks to the same file, folder, email, etc. Invoking Hook on a folder could bring up a Hook window that looks similar to this one, with multiple Craft links:

Screenshot Hooks.png

The screenshot above shows four Craft links attached to the folder “Recent Rochelle Photos” via Hook. The first link is to a Craft document, and it was created using Hook. The last three links are Craft deeplinks that haven’t been renamed; they go to specific blocks within the same Craft document.

Paste links to Craft documents anywhere

You can also paste any link or deeplink copied from Craft – either via Hook or via Craft’s own link copying function – anywhere that you can paste text. Clicking it will open Craft to the linked page or block.

Using Hook-garnered links in Craft

Craft is designed to integrate easily with other apps and services, and opens hyperlinks pasted into Craft. This makes it easy to use Hook-garnered links in Craft by using Hook to copying any link and pasting the link anywhere in a Craft document. Craft will display a hyperlink with the name of the item you’ve linked to. Click the hyperlink to open a file, folder, email, Contact card, task, web page, etc.

You can also “hook” or attach linkable items to a Craft document. Once you have used Hook to copy a link, just select your Craft document, invoke Hook and either select Hook to Copied Link or hit ⌘V. To see and use the links you’ve hooked to a Craft document, invoke Hook from within your Craft documents:

Hook window Screen Shot 2021-02-26 at 16.47.54.png

To open the hooked item, select it (by using the arrow keys, your mouse/trackpad, or with the keyboard shortcut shown.) If the resource is a file or folder, you may also use Hook’s menu to reveal it in the Finder.

Hook a new item to any Craft document

In any Craft document you can invoke Hook and choose the Hook to New… command from Hook’s Title bar (or use ⌃⌘N) to create a new item and hook it to the Craft document.

Hook will automatically do all of the following for you:

  1. create the new item document,
  2. name it after the Craft document,
  3. if the new item is a file, Hook will (a) store it in a default Finder folder, and (b) optionally apply a “Hook” Finder tag to the new file, and
  4. bidirectionally link (“hook”) the Craft document to the new item.

<code>Hook to New</code> Screen Shot 2021-02-26 at 16.48.19.png” /></p>
<p>As an example, you might want to link the Craft document to a task in <a href=OmniFocus, Things or TaskPaper. Now you can invoke Hook on the new item. You will see a Hooked link to the new project —and vice-versa! That way, you can easily navigate between your Craft document and your writing plan.

Hook to New > Craft

Later this month Hook 2.3 will be released. At that point, you will also be able to use Hook to New in the other direction. You will be able to use the Hook to New command to create a new Craft document that is hooked (bidirectionally linked) to a document, file, folder or any other currently selected linkable resource.

A common use case will be to invoke Hook in the context of a PDF (say in PDFpenPro) and choose Hook to New > Craft. That way, you will be able to use Craft to write notes about your PDF. (The value of long-form note-taking about documents is discussed in Cognitive Productivity books books.)

Hook effortlessly bookmarks your Craft links

Hook effortlessly bookmarks all the links you copy with Hook, including Craft links. As a result, you can use Hook to find your most important Craft documents — the ones that were worth addressing!

To find Craft documents and blocks whose links you’ve copied with Hook:

  1. Invoke Hook.
  2. Type ⌘F or Gear Menu > Find.
  3. Type craftdocs and hit the return key.

Your “hooked” Craft documents will show up in the search results. There’s a good chance that you’ve already bookmarked important Craft documents with Hook, so use Hook to search for relevant information.


This requires Hook version 2.2.2 or later with integration scrips v. 162 or later. It also requires macOS Big Sur.

See also