WikiLinks provide easy linking between pages of the wiki. To create a WikiLink, just put the name of the page to link to in double brackets. For example [[WikiLink]].

If you ever need to write something like [[WikiLink]] without creating a wikilink, just prefix it with a \, like \[[WikiLink]].

There are some special LinkingRules that come into play when linking between SubPages.

Also, if the file linked to by a WikiLink looks like an image, it will be displayed inline on the page.

WikiLinks are matched with page names in a case-insensitive manner, so you don’t need to worry about getting the case the same, and can capitalise links at the start of a sentence, and so on.

It’s also possible to write a WikiLink that uses something other than the page name as the link text. For example [[foo_bar|SandBox]] links to the SandBox page, but the link will appear like this: foo bar.

To link to an anchor inside a page, you can use something like [[WikiLink#foo]]

Preprocessor directives and wikilinks

ikiwiki has two syntaxes for preprocessor directives. The older syntax used spaces to distinguish between preprocessor directives and wikilinks; as a result, with that syntax in use, you cannot use spaces in WikiLinks, and must replace spaces with underscores. The newer syntax, enabled with the prefix_directives option in an ikiwiki setup file, prefixes directives with !, and thus does not prevent links with spaces. Future versions of ikiwiki will turn this option on by default.