This page is part of a static HTML representation of the TiddlyWiki at http://tiddlywiki.com/

Linking in WikiText

7th June 2016 at 10:52am

A key capability of WikiText is the ability to make links to other tiddlers or to external websites.

Manual Links

Link to a tiddler by title:

[[Tiddler Title]]

To link to a tiddler and specify the text of the link:

[[Displayed Link Title|Tiddler Title]]

You can also create a link from the editor toolbar. Click link ( ), and search and select a tiddler.

CamelCase Links

For tiddler titles that match the CamelCase rules, just typing the title without double square brackets will automatically create a link.

You can suppress a link from being recognised by preceding it with ~. For example:

* ~HelloThere is not a link
* ~http://google.com/ is not a link

That renders as:

  • HelloThere is not a link
  • http://google.com/ is not a link

... and the underlying HTML is:

<ul><li>HelloThere is not a link</li><li>http://google.com/ is not a link</li></ul>

External Links

To link to an external resource such as a website or a file, type its full URL, including the URI scheme such as a protocol (e.g. http://, file://) or mailto:

http://tiddlywiki.com/

[[TW5|http://tiddlywiki.com/]]

[[Mail me|mailto:me@where.net]]

For this syntax to work, the URL has to be recognisable as a URL. Otherwise, it is treated as a tiddler title. As a result, in case you want to link to a resource locatable using a relative path, use the extended syntax:

[ext[Open file|index.html]]

[ext[Open file|./index.html]]

[ext[Open file|../README.md]]

The extended syntax still works with full URLs, although in that case it is not necessary:

[ext[http://tiddlywiki.com]]

[ext[TW5|http://tiddlywiki.com]]

You can also use the extended syntax to force an external link:

[ext[Donate|bitcoin:1aabbdd....?amount=0.001]]

Customising Tiddler Links

See the LinkWidget for details of the underlying widget used to implement tiddler links, including macros that can be used to customise its behaviour.