Back to Notenik.app


The Notenik Knowledge Base

10.2 Notenik Markdown Parser ↑

Notenik allows the user to create a link from one Note to another Note within the same Collection.

In order to enable this option, the user must be using Notenik’s own internal Markdown parser.

The Notenik Markdown parser supports double-bracket wiki-style links as an extension to the original Markdown spec from John Gruber.

If you are using Notenik’s parser, then a link to another Note may be coded by simply enclosing the title of the target Note within double square brackets, like this – [[Overview]] – and a click on the resulting link will take you to that note.

If Notenik cannot initially find the target for a link, it will attempt to take possible singular/plural variation into account, in this way: if the link target ends with the letter ‘s’, then Notenik will try again with the trailing ‘s’ removed; if the link target does not end with an ‘s’, then Notenik will try adding the letter ‘s’ to the end. If such a change successfully identifies a Note, then that Note will be used as the target of the wiki link.

If you code a wiki style link, in double square brackets, to a Note that does not yet exist, then after saving the edits to the Note and redisplaying it, the new Note (the target of the link) may be created for you automatically. The new Note will have the targeted Title assigned, and body text containing a link back to the referencing Note. This auto-creation behavior is optional, and can be enabled by checking a box in the Collection Settings window.

If you also enable the timestamp field for a Collection, then you can change the title of a linked Note without changing the referencing wiki link text, and Notenik will remember the association between the old title and the new title, making use of the timestamp field to preserve a unique, unchanging identity for each Note. These associations will be saved in a special file named ‘alias.txt’, within the Collection folder. This functionality can be useful to make sure you don’t end up with broken links between Notes.

Be sure and check out the ability to Select a Note for Action for an easy way to select a target Note and insert a wiki link to that second Note.

The linked text normally shows the title of the Note that is the target of the link, but the linked text may be altered by placing a vertical bar (aka a pipe symbol) after the title of the target Note, followed by the text to be used as the linked text.

As an example, the following code:


[[Backup to Zip|Zip Backup]]

… will appear as Zip Backup, but will still link to Backup to Zip.


Next: Wiki Links Between Collections