Permalinks allow direct links to individual tiddlers within a TiddlyWiki.
The simplest form of permalink () is a single target tiddler title appended to the base URL with
The tiddler title can contain spaces if required:
Note that double square brackets are not required around the target tiddler title; however, if present they are silently removed.
The permalink can also specify the story list of tiddlers that should be opened alongside the target tiddler as a TiddlerFilter:
If the target tiddler isn't present in the story list then it is automatically inserted at the top. This means that the following two examples both target the tiddler
Tiddlers within the story sequence
It is also possible to specify a story filter without specifying a target tiddler for navigation:
There are technical restrictions on the legal characters in an URL fragment. To allow all tiddler titles to be addressed, illegal characters are subject to a process called "URL encoding" whereby problematic characters are replaced by their numeric code. For example, the space character is replaced with
Both the target tiddler title and the story filter should be URL encoded (but not the separating colon). TiddlyWiki generates properly encoded URLs which can look quite ugly. However, in practice browsers will usually perfectly happily process arbitrary characters in URL fragments. Thus when creating permalinks manually you can choose to ignore URL encoding.
Note that typing or navigating to a permalink will always cause the permalink to be processed, and tiddlers opened and closed as appropriate.
When TiddlyWiki starts up it processes permalinks according to the following steps; the same steps are repeated if the permalink changes dynamically (this happens in response to the user editing the address bar, for example).