Support for Wiki Links¶

Wiki links offer a simple method for citing and referencing other pages in the documentation without lengthy URLs. Wiki links are the preferred method for linking to other pages in the documentation, so please use them whenever possible.

Basic Syntax¶

The basic syntax for a wiki link is:

page

Where:

• page is the title of the target page

Full Syntax¶

The full syntax for a wiki link is:

  Custom caption

When resolving a wiki link, the system follows these rules:

Page Title¶

(Mandatory) The 'page' in a wiki link refers to the title specified in the nav attribute of the mkdocs.yml file. For example,

nav:
  - Home: index.md
  - MyRef X: reference.md

provides the following wiki link:

MyRef X

Path Hints¶

(Optional) You can use path hints to specify the location of the file. The syntax is:

page

Where:

• hintpath/to is the path (or prefix) to the file
• page is the title of the target page

Anchors¶

(Optional) Use anchors to link to specific sections within a page. If the page does not have an anchor, the link would render as the caption provided, and you'll find a warning in the build process.

page

Where:

• page is the title of the target page
• anchor is a specific section within the page

Custom captions¶

(Optional) Provide custom text to display for the link instead of the page title.

Custom caption

Where:

• page is the title of the target page
• anchor is a specific section within the page

Captions can include icons, for example:

[:material-link: this is a caption with an icon](https://specs.anoma.net/main/index.html)

List of wiki-style links per Page¶

By default, the build process will generate a list of all wiki-style links per page. This list is displayed at the bottom of the page, and it is useful for identifying broken links or pages that are not linked to from other pages.

To disable this feature, set the list_wikilinks option to false in the front matter of the page.

list_wikilinks: false

Additionally, you could see a mermaid graph of the links by setting the graph_wikilinks option to true in the front matter of the page. This, however, may render graphs that are too large to be useful. Thus, it is set to false by default.

graph_wikilinks: true