Links

Syntax

The link syntax links one node to another. It begins with a pipe and a space | and ends with a space and a right angle bracket > . Between is a node ID. Links receive syntax highlighting:

| This is a link to the node with this ID >

Linking does not require a filename or any other information, only the node ID. See Node IDs for more information.

How to Open Links

Pressingctrl + shift + / on a line containing a link will open the link, scrolling to and centering the destination node. If there is more than one link on a line, the cursor is inside a link, or the cursor is not in a link, the first link after the cursor, will be opened. Links on other lines are not opened.

Links IDs are Dynamic

Whenever the ID of a node is modified, Urtext will attempt to update all links in the project to that node to the new ID. In rare cases, manually updating may be required.

Link Modifiers

Links are user- or system-modified by adding a character immediately following the opening pipe |:

Missing Node Link

If a linked node cannot be located in the current project, it will be assigned the question mark ? modifier:

|? This is a link that cannot be located in the project >

The missing link modifier is not editable, it will be present as long as the target node link does not exist.

Trigger Link

The exclamation mark ! modifier makes an trigger link. It executes the frame in a target node without visiting the target node. See Frames and Calls for more information.

|! This is an trigger link >

File Link

To link to a file, use the file link syntax, a single forward slash / immediately following the opening pipe character.

File paths may be relative or absolute, depending on whether the path itself has a leading slash:

|/ relative/path-to-file/file.txt >

|/ /absolute/path-to-file/file.txt >

The tilde (~) character resolves UNIX paths to the user’s home folder:

|/ ~/Desktop/Filename.pdf >

File links are opened using the system default for the file type or extension. Urtext imposes no default behavior. To open the file in Sublime Text (i.e. if it is a text or other human-readable file), set your operating system to open that file type in Sublime Text.

URI Link

URIs such as web links are recognized automatically and do not require link wrappers. They are opened with the system default browser or application.

https://urtext.co

Pointers

Pointers are links with special behavior in Urtext. See Pointers.

Link-Related Actions

Several Actions can make inserting links quick and easy:

Link To
Link From

Insert Link to File
(links and documentation to be added shortly)