Eddy Luten

Mkdocs

Last updated: 
0 min read

MkDocs Alias Plugin

7 min read

The mkdocs-alias-plugin MkDocs plugin allows links to your pages using custom aliases:

This is a link to [[my-page]].
This is a link to [[my-page|the same]] alias.

Using aliases allows you to decouple the file structure of your MkDocs wiki from its taxonomy. For example, if you have a wiki about animals which accidentally classifies pigs as reptiles, after moving the file into the mammals directory, you won’t have to update all of the links to the pig page. Depending on the size of your wiki, this can save quite a bit of time.

Read all 1,403 words