Open ooker777 opened 8 months ago
With this mkdocs.yml:
mkdocs.yml
site_name: test plugins: - ezlinks: wikilinks: true
And this folder structure:
docs/ ├── index.md └── a/ └── index.md
After the build we will have:
site/ ├── index.html └── a/ └── index.html
If in docs/index.md you have this content:
docs/index.md
[[a/index]] [[a/index.md]] [[./a/index]] [[./a/index.md]]
Then in site/index.html the html will be:
site/index.html
| docs/index.md | site/index.html | Correct? | | ---------------- | -------------------------------------------------- | -------- | | [[a/index]] | <a href="a/" title="a/index">a/index</a> | ✔ | | [[a/index.md]] | <a href="a/" title="a/index.md">a/index.md</a> | ✔ | | [[./a/index]] | <a href="a/index" title="./a/index">./a/index</a> | ❌ | | [[./a/index.md]] | <a href="a/" title="./a/index.md">./a/index.md</a> | ✔ |
At the same time Mkdocs will notice this:
INFO - Doc file 'index.md' contains an unrecognized relative link 'a/index', it was left as is. Did you mean 'a/index.md'?
With this
mkdocs.yml
:And this folder structure:
After the build we will have:
If in
docs/index.md
you have this content:Then in
site/index.html
the html will be:At the same time Mkdocs will notice this: