Using Hook with the Free Skim PDF Reader app: Deep Links!

Hook enables you to link PDF files to and from anything that is also linkable. Hook supports many PDF readers including the excellent, free PDF reader, Skim, available on Sourceforge.io.

Hook treats PDFs similarly to any other files, except you can create “deep links” that point to specific locations in a document.

Click on the link and Hook will open the PDF and scroll to the specific page and location to which it points!

Copy Link, Copy Markdown Link and Hook to Copied Link

By default, Hook’s Copy Link and Copy Markdown Link in Skim copies links of the form hook://file// which point to the entire PDF file. You can paste those links anywhere.

In addition, you can create deep links to specific locations in a PDF (i.e., a specific page number and place on that page.)

Creating Deep Links (to specific locations in a PDF file)

If you have selected something in the PDF when you invoke Copy Link or Copy Markdown Link, then Hook will copy a “deep link” to the specific location of the selection! This is super handy for anyone who is working intensely with PDFs.

  1. In Skim or PDFPenPro, select the text or image to which you want to create a link.
  2. Bring up Hook using a keyboard shortcut (⇧⌘SPACE by default) or the Hook menu bar icon.
  3. Click Hook’s Copy Link button (or use ⌘C, or use Copy Markdown Link).
  4. Paste the link wherever you want to directly link to the selection.

When you click the link, Hook opens the file and jumps to the specific section of the PDF, provided your default PDF reader supports PDF deep linking. (As of 2021-01-07 this includes Skim and PDFpenPro. Other apps may be supported later).

You can paste the link in:

  • any document (for instance in Pages, Nisus Writer, or Microsoft Word), even in another PDF !
  • a “to-do” app (such as OmniFocus, Things or TaskPaper),
  • an email
  • in any editable field (even Items in DEVONthink )
  • and just about anywhere else

Share deep links to PDFs with others!

Before Hook, there was no easy way to refer to shared PDFs in Dropbox or iCloud. Hook solves this problem. Use the Copy Link (or Copy Markdown Link) command on a PDF or a selection of the PDF, then paste the link into a document or email. Send it to anyone with access to the PDF: If they have Hook (even if they use its free Lite mode), the deep links will open at the exact location in the PDF.

That way, instead of manually scrolling to the location in a (potentially very long) PDF, all they need to do is click on the link.

Hook links to specific locations in PDF files that are shared with others will normally work as long as the recipient has Hook and Skim installed and a copy of the file that has the same unique name on the recipient’s Mac (if two files have the same name, Hook will try to disambiguate them based on its meta-information [not its content]).

Try it, you and your recipients will be amazed at the time (and communication) savings!

Default app for opening PDFs

In order to use Hook’s deep links to PDFs you currently need to ensure that the default app you have configured in macOS Finder to open “.pdf” files supports deep PDF links. (As of 2021-01-07 this includes Skim and PDFpenPro. Additional apps may be added). See Choose an app to open a file on Mac – Apple Support.

Even today, however, Hook also supports deep PDF links with Curio using an alternative integration. In Curio, PDFs are not stand-alone files that you directly access with Finder. They are embedded in Curio documents.

Switching between PDF readers, and compatibility of deep PDF links

Hook’s deep PDF links are designed with the same standard-compliance principles and philosophy as Hook’s email links. (See Openness).

Where Hook’s email URLs (hook://email/<ID>) utilize RFC 5322 compliant email identifiers, Hook’s deep PDF URLs (hook://file//<...>p=<page-number>&s<starting-point>&e=<end-point>) use coordinate information specified in PDF specifications.

This means you can switch from one PDF app to another — as long as the other app supports automated deep linking. You can copy a deep PDF link in one app ( Skim) and open said deep links in another app (PDFpenPro).

Preventing deep links from being formed

If you’d rather get a link to the entire PDF, rather than a deep link, then prior to using the Copy Link or Copy Markdown Link command, simply clear the selection in Skim. You can do this by option-clicking in the margin of a PDF in Skim (or close and reopen the PDF file).

Hook to New > Skim

Hook does not currently support the creation of new PDFs. So there’s no Skim item in the Hook to New menu.

Searching for PDFs that you’ve bookmarked with Hook

To find PDF files you’ve linked with Hook, simply

  1. invoke Hook,
  2. enter search mode (with ⌘F or a click of Hook’s search toolbar-button),
  3. type ".pdf" and hit the return key (for a more precise search: "pdf" url:"hook://file")

Your PDF bookmarks will show up in the search results. This is a very handy trick, so it’s a good idea of getting into the habit of using Hook’s search feature.

Think of it this way: if something is important you’ve likely bookmarked it with Hook (e.g., by copying a link to it). So use Hook to search for relevant information.

Requirements

This requires Hook 2.2 or later with integration scripts v. 150.

Readdle’s PDF Expert

We’re sometimes asked about Readdle’s PDF Expert, so we mention here that as of this writing, PDF Expert for macOS is still not a linkable app as defined in What’s a Linkable App and Why Does Linkability Matter? – Hook.

See also Contacting Developers of Other Apps and Information for Developers – Hook.

See also…

Luc Beaudoin’s two Cognitive Productivity books explain in great detail how you can use the Skim PDF reader to boost your cognitive productivity.

Skim is also discussed and illustrated elsewhere on this website. To find out more: