wiki VS retype

There's also the selfhosted show wiki https://wiki.selfhosted.show/

I had the same requirements as you, and MkDocs has worked wonderfully well for me. You can use this repository as an example: https://github.com/selfhostedshow/wiki/

Outside of Swift, I use RetypeApp and they have a lot of inbuilt functionality. You can then generate your output directory on build, and use those HTML files as is.

You can build pretty beautiful docs with: - https://retype.com - https://docusaurus.io - https://www.intercom.com/articles

Retype is the nicest one I’ve come across in my search! Has a built in table of contents, pretty easy to create (entirely using markdown) and great support for emojis, math, containers, multi tab info panels, and proper dropdown panels.

Are you aiming at creating something like this? With a bar on the left with folders?

I recently set up something with https://retype.com/ and it's quite good.

While gitbook does wrap the branching/merging process in a UI that is digestible by non-developers, Retype is far more powerful because you actually use GitHub (or GitLab). You have the full power of GitHub, including branching, pull-requests, issues, reviews, automation, authentication, and everything else.

For example, here's the repo for the retype.com website, see https://github.com/retypeapp/retype

The entire website is built from simple Markdown text files.