Ziplinks is the new name for the old Quick Links, whose function has been completely rewritten as of v8.6.0. The ziplinks method is particularly useful for adding references to glossary terms, frequently-used sources, or oft-mentioned people and places; in fact anything where the destination note name makes logical anchor text for the link.
Note that ziplinks are a keyboard-centric method, albeit enhanced, of creating normal text links with normal link anchor text. Once the link is generated, the link anchor is no different from any other text link anchor, i.e. ziplinks do not create a special type of anchor text.
To make a ziplink to a named note, precede the name of the note with two square brackets and follow its name with two square brackets like this
[[like this]]. If there is no note with this name in the document, Tinderbox will create one as the sibling of the note being editing. Once zip links creation is invoked the following logic applies:
[[ shows a list of all notes in the current document.
[[D shows a list of all notes with names that contain a "d" (case-insensitive match).
In documents with many notes it makes sense to type a few characters to avoid excessive numbers of possible matches being listed.
When typing a ziplink, Tinderbox will show a list of related note names to the left of the text pane; the list displays all notes that contain the ziplink string, not just those that begin with the string. Choose any of these listed notes to make the link (without further typing); or, press the up-arrow or down-arrow keys to select the preferred target note then press the Return key (↩) to complete the link. When typing a ziplink, you can choose that option by pressing Tab key (⇥) if either:
- there is only one choice in the ziplink menu
- an item in the quicklink window has been selected with the up-arrow and down-arrow keys.
Each item in the ziplink popup menu shows a tool tip with the note's full path.
Locale-based sorting. When typing a ziplink on an English locale system, diacritics are ignored when looking for matches. However, the ziplinks list of related notes takes into account the user's locale, so 'étude' will sort appropriately for French users and 'Ångstrom' will sort correctly in Norway. Bear in mind the process works off the OS locale so if working under one locale and using accented characters from a different language/locale sorting is still locale based.
Linking to a note in a specified container
If wishing to make a ziplink to a note in a different container, type the container path in the ziplink:
Additional logical syntax applies when typing paths:
[[/ shows a list of all top-level containers.
[[/D shows a list of all top-level notes that begin with a "d" (case-insensitive match).
[[/Dog/ shows a list of all notes in /Dog.
[[/Dog/R shows a list of all notes in /Dog that begin with "r".
[[./ shows a list of all siblings of this note.
[[../ shows the parent of this note and all the parent's siblings.
When typing the start of a ziplink, e.g.
[[A, Tinderbox shows all notes in the document starting with A. Typing
[[/container/A, Tinderbox shows only notes in the specified container. To see a list of just those notes that are siblings of this note, type
[[./A (note the full stop before the slash character).
When typing ziplinks, the popup menu displays names of containers in bold. Selecting a container from the ziplink menu does not close the ziplink immediately. Instead, a new menu of items inside the container appears. Type closing brackets "]]" to link to the container, or select any note or container inside that container from the menu.
From v8.7.0, when typing a zip link, Tinderbox now prefers to link to the original note rather than an alias. Pressing [tab] selects the option currently selected in the popup menu. If no item is selected but there is only one item in the menu, pressing [tab] selects it. If there are several items in the menu but none is selected, [tab] selects the first item.
Adding anchor text for the new link
The ziplink syntax allows for specifying link anchor text, using a pipe ('|') symbol delimiter. The following will replace the brackets with the anchor text and link it to the designated note.:
[[note name|anchor text]]
If also needing to specify additional $Text for the note (see below), it goes after the optional anchor text:
Adding text to the target note
To aid rapid note-taking, it is possible to also set or add to the $Text of a ziplink target note:
[[note::some new text]]
If the note already exists, the new text is appended to the note's existing $Text. Otherwise, the supplied text forms the entire $Text of the new note; where no text is supplied, new notes generated by ziplinks have no $Text.
From v8.6.1, there is no limit on the size of thev ziplinks input string. Previously it was limited to 50 chars.If needing to add more target text than is currently supported, there is a simple alternative. Create the ziplink without adding any text. Then either click the link. This navigates to the link target. Now add the desired $Text. Then use shortcut [Cmd]+['] (⌘+') to navigate back to the original note. These navigation controls are also accessible from the Note menu.
Adding a backlink from the link target
From v8.7.0, Ziplinks can create backlinks from the destination note. [[<that note>]] will create a link to "that note", and then will append the name of this note to the text of "that note" and link the name back to this note.
Quick links behaviour pre-v8.6.0
The previous 'Quick links' behaviour using a "[[" trigger is described separately.