__ __ _ _
| \/ | __ _ _ __| | ____| | _____ ___ __
| |\/| |/ _` | '__| |/ / _` |/ _ \ \ /\ / / '_ \
| | | | (_| | | | < (_| | (_) \ V V /| | | |
|_| |_|\__,_|_| |_|\_\__,_|\___/ \_/\_/ |_| |_|
____
| _ \ _ __ ___ ___ ___ ___ ___ ___ _ __ ___ _
| |_) | '__/ _ \ / __/ _ \/ __/ __|/ _ \| '__/ __(_)
| __/| | | (_) | (_| __/\__ \__ \ (_) | | \__ \_
|_| |_| \___/ \___\___||___/___/\___/|_| |___(_)
____ _ _ _ ____ _
/ ___| _ _ _ __ _ __ _ __(_)___(_)_ __ __ _| |_ _ | __ ) __ _ __| |
\___ \| | | | '__| '_ \| '__| / __| | '_ \ / _` | | | | | | _ \ / _` |/ _` |
___) | |_| | | | |_) | | | \__ \ | | | | (_| | | |_| | | |_) | (_| | (_| |
|____/ \__,_|_| | .__/|_| |_|___/_|_| |_|\__, |_|\__, | |____/ \__,_|\__,_|
|_| |___/ |___/
Modern wiki software only fits other people’s purposes - none seem designed for someone who has markdown notes and wants to interact with them. Switching wiki software demands changing the notes to adhere to the software’s new standards. I can’t find a single project which says ‘we will process your markdown’.
Gitlab’s wiki uses Gollum, which insists that links look like this:
Golum is an awful wiki. See my [review here](/wikis/golum_review/).
But while you’re writing the file wikis/overview.md, then the natural way to link to wikis/golum_review.md should be a link to that file:
Golum is an awful wiki. See my [review here](golum_review.md).
The link to another markdown file should say where that markdown file is. The linking system here clearly thinks in terms of a website address rather than linked notes.
The Gitea wiki has no such limit, but somehow manages to find a worse one: it cannot show files inside a directory and they don’t plan to change that limitation. This basic directory structure is impossible:
writing/
├── ed.md
├── emacs.md
├── ghostwriter.md
├── helix.md
└── vim.md
wikis/
├── gitea.md
├── golum.md
├── links.md
└── vim.md
Instead, everything must remain in the root directory. People have raised this as an issue[i], and the Gitea devs closed it, so now all the wikis have this structure:
├── ed.md
├── emacs.md
├── helix.md
├── ghostwriter.md
├── gitea.md
├── golum.md
├── links.md
├── vim.md
└── vim_2.md
Worst of all, both Gitea and Gollum suffer from a GUI which demands that spaces are represented with hyphens.
Filename you write | Title you get
--------------------|-----------------
Forest_Walks.md | Forest_Walks
Forest-Walks.md | Forest Walks
Walks_-_Forestry.md | Walks__Forestry
It’s a shite state of affairs.
Markdown apps are no better.
[i]