*Fork*
To install this fork :
`pip install mkdocs-wikilinks-plugin`
# mkdocs-wikilinks-plugin
Plugin for mkdocs which enables easier linking between pages.
This plugin was written in order to provide an up-to-date and
feature complete plugin for easily referencing documents
with a variety of features:
* Optimized file name lookup
* Code Block Preservation
* File name linking (e.g. `[Text](file#anchor "title")`)
* Absolute paths (e.g. `[Text](/link/to/file.md)`)
* WikiLinks support (e.g. `[[Link#anchor|Link Title]]`)
* Reference Link support (e.g. `[foo]: bar/ "Foo Title"`)
# Install
```
pip install mkdocs-wikilinks-plugin
```
Edit your mkdocs configuration file to enable the plugin:
```
plugins:
- search
- ezlinks
```
> **NOTE**
> If you have no plugins entry in your config file yet, you'll likely also want to add the search plugin. MkDocs enables it by default if there is no plugins entry set, but now you have to enable it explicitly.
# Configuration Options
```
plugins:
- search
- ezlinks:
wikilinks: {true|false}
```
## wikilinks
Determines whether to scan for wikilinks or not (See [WikiLink Support](#wikilink-support)).
> **NOTE**
> This plugin feature does not function well when the 'wikilinks' markdown extension is enabled. This plugin's functionality should replace the need for enabling said extension.
## reference_links
Determins whether to scan for Reference Links or not (See [Reference Links](https://spec.commonmark.org/0.29/#reference-link), e.g. `[foo]: /bar "Foo Bar"`)
# Features
## Filename Links
Given a layout such as
```
- index.md
- folder/
+-- filename.md
+-- image.png
```
The following links will result in the following translations,
|Link|Translation|
|----|-----------|
| `[Link Text](filename)` | `[Link Text](folder/filename.md)`|
| `[Link Text](filename#Anchor)` | `[Link Text](folder/filename.md#Anchor)`|
| `[Link Text](filename.md)` | `[Link Text](folder/filename.md)`|
| `[Link Text](filename.md#Anchor)` | `[Link Text](folder/filename.md#Anchor)` |
| `` | `` |
| `` | `` |
| `` | `` |
## Absolute Links
Given a layout such as
```
- static/
+-- image.png
- folder/
+-- document.md
- index.md
```
Given that we are entering the links into the `folder/document.md` file,
|Link|Translation|
|----|-----------|
| `` | `` |
# WikiLink Support
Given a layout such as
```
- folder1/
+-- main.md
- folder2/
+-- page-name.md
- images/
+-- puppy.png
```
and these links are entered in `folder1/main.md`, this is how wikilinks will be translated
|Link|Translation|
|----|-----------|
| `[[Page Name]]` | `[Page Name](../folder2/page-name.md)` |
| `![[Puppy]]` | `` | `[[Page Name#Section Heading]]` | `[Page Name](../relative/path/to/page-name.md#section-heading)` |
| `[[Page Name\|Link Text]]` | `[Link Text](../folder2/page-name.md)` |
| `[[Page Name#Section Heading\|Link Text]]` | `[Link Text](../folder2/page-name.md#section-heading)` |
# Attribution
This work is highly inspired from the following plugins:
- [mkdocs-autolinks-plugin](https://github.com/midnightprioriem/mkdocs-autolinks-plugin/)
- [mkdocs-roamlinks-plugin](https://github.com/Jackiexiao/mkdocs-roamlinks-plugin)
- [mkdocs-abs-rel-plugin](https://github.com/sander76/mkdocs-abs-rel-plugin)
I have combined some the features of these plugins, fixed several existing bugs, and am adding features in order to
provide a cohesive, up-to-date, and maintained solution for the mkdocs community.
Raw data
{
"_id": null,
"home_page": "https://github.com/carlos-truong/mkdocs-wikilinks-plugin",
"name": "mkdocs-wikilinks-plugin",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "mkdocs, wikilinks, ezlinks, obsidian, roam",
"author": "Carlos",
"author_email": "carlos.truong.dev@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/17/1f/1229d42def623d1a2a03e233a06789a858aee94441428a7c18322154124e/mkdocs_wikilinks_plugin-0.1.2.tar.gz",
"platform": null,
"description": "*Fork* \nTo install this fork : \n`pip install mkdocs-wikilinks-plugin` \n\n# mkdocs-wikilinks-plugin\n\n\n\nPlugin for mkdocs which enables easier linking between pages.\n\nThis plugin was written in order to provide an up-to-date and\nfeature complete plugin for easily referencing documents\nwith a variety of features:\n\n* Optimized file name lookup\n* Code Block Preservation\n* File name linking (e.g. `[Text](file#anchor \"title\")`)\n* Absolute paths (e.g. `[Text](/link/to/file.md)`)\n* WikiLinks support (e.g. `[[Link#anchor|Link Title]]`)\n* Reference Link support (e.g. `[foo]: bar/ \"Foo Title\"`)\n\n# Install\n```\npip install mkdocs-wikilinks-plugin\n```\n\nEdit your mkdocs configuration file to enable the plugin:\n```\nplugins:\n - search\n - ezlinks\n```\n> **NOTE** \n> If you have no plugins entry in your config file yet, you'll likely also want to add the search plugin. MkDocs enables it by default if there is no plugins entry set, but now you have to enable it explicitly.\n\n# Configuration Options\n```\nplugins:\n - search\n - ezlinks:\n wikilinks: {true|false}\n```\n\n## wikilinks\nDetermines whether to scan for wikilinks or not (See [WikiLink Support](#wikilink-support)).\n> **NOTE** \n> This plugin feature does not function well when the 'wikilinks' markdown extension is enabled. This plugin's functionality should replace the need for enabling said extension.\n\n## reference_links\nDetermins whether to scan for Reference Links or not (See [Reference Links](https://spec.commonmark.org/0.29/#reference-link), e.g. `[foo]: /bar \"Foo Bar\"`)\n\n# Features\n## Filename Links\nGiven a layout such as\n```\n- index.md\n- folder/\n +-- filename.md\n +-- image.png\n```\n\nThe following links will result in the following translations,\n\n|Link|Translation|\n|----|-----------|\n| `[Link Text](filename)` | `[Link Text](folder/filename.md)`|\n| `[Link Text](filename#Anchor)` | `[Link Text](folder/filename.md#Anchor)`|\n| `[Link Text](filename.md)` | `[Link Text](folder/filename.md)`|\n| `[Link Text](filename.md#Anchor)` | `[Link Text](folder/filename.md#Anchor)` |\n| `` | `` |\n| `` | `` |\n| `![Image Alt Test](image \"Image Title\")` | `![Image Alt Text](folder/image.png \"Image Title\")` |\n\n\n## Absolute Links\nGiven a layout such as\n```\n- static/\n +-- image.png\n- folder/\n +-- document.md\n- index.md\n```\nGiven that we are entering the links into the `folder/document.md` file,\n\n|Link|Translation|\n|----|-----------|\n| `` | `` |\n\n# WikiLink Support\nGiven a layout such as\n```\n- folder1/\n +-- main.md\n- folder2/\n +-- page-name.md\n- images/\n +-- puppy.png\n```\nand these links are entered in `folder1/main.md`, this is how wikilinks will be translated\n\n|Link|Translation|\n|----|-----------|\n| `[[Page Name]]` | `[Page Name](../folder2/page-name.md)` |\n| `![[Puppy]]` | `` | `[[Page Name#Section Heading]]` | `[Page Name](../relative/path/to/page-name.md#section-heading)` |\n| `[[Page Name\\|Link Text]]` | `[Link Text](../folder2/page-name.md)` |\n| `[[Page Name#Section Heading\\|Link Text]]` | `[Link Text](../folder2/page-name.md#section-heading)` |\n\n# Attribution\nThis work is highly inspired from the following plugins:\n - [mkdocs-autolinks-plugin](https://github.com/midnightprioriem/mkdocs-autolinks-plugin/)\n - [mkdocs-roamlinks-plugin](https://github.com/Jackiexiao/mkdocs-roamlinks-plugin)\n - [mkdocs-abs-rel-plugin](https://github.com/sander76/mkdocs-abs-rel-plugin)\n\n I have combined some the features of these plugins, fixed several existing bugs, and am adding features in order to\n provide a cohesive, up-to-date, and maintained solution for the mkdocs community.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A mkdocs plugin that makes linking to other documents easy.",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/carlos-truong/mkdocs-wikilinks-plugin"
},
"split_keywords": [
"mkdocs",
" wikilinks",
" ezlinks",
" obsidian",
" roam"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3fd8d4f08af8762c41c2478e3303038f02b518d010d5c0975630e390a84fa58b",
"md5": "76d473d7cf3acdd4ab3aca4ed91423d4",
"sha256": "b562002d055e8d493eeb04ad26727190cb75b68f754e699b0fa5ab0d23884c5c"
},
"downloads": -1,
"filename": "mkdocs_wikilinks_plugin-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "76d473d7cf3acdd4ab3aca4ed91423d4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 11796,
"upload_time": "2025-11-08T03:37:56",
"upload_time_iso_8601": "2025-11-08T03:37:56.489691Z",
"url": "https://files.pythonhosted.org/packages/3f/d8/d4f08af8762c41c2478e3303038f02b518d010d5c0975630e390a84fa58b/mkdocs_wikilinks_plugin-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "171f1229d42def623d1a2a03e233a06789a858aee94441428a7c18322154124e",
"md5": "28c2207a296259324a1c89435047db21",
"sha256": "4256b69ef586bec3166e70d16561c969571ab3f1580b823e89e1a85be3997503"
},
"downloads": -1,
"filename": "mkdocs_wikilinks_plugin-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "28c2207a296259324a1c89435047db21",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 10391,
"upload_time": "2025-11-08T03:37:57",
"upload_time_iso_8601": "2025-11-08T03:37:57.735548Z",
"url": "https://files.pythonhosted.org/packages/17/1f/1229d42def623d1a2a03e233a06789a858aee94441428a7c18322154124e/mkdocs_wikilinks_plugin-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-11-08 03:37:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "carlos-truong",
"github_project": "mkdocs-wikilinks-plugin",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "mkdocs",
"specs": []
},
{
"name": "dataclasses",
"specs": [
[
">=",
"0.7"
]
]
},
{
"name": "pygtrie",
"specs": [
[
"==",
"2.*"
]
]
}
],
"lcname": "mkdocs-wikilinks-plugin"
}
JSON
