Goals:
- Super easy to and quick to edit.
- Nice HTML output with solid sidebar navigation.
- Decent search built-in.
First I tried a FogBugz Wiki. Then I started looking at DocBook, then Sphynx, and then AsciiDoc was looking good. Then I found mdoc. Yeah baby!
Look at the output. Isn't that beautiful?
Using mdoc on Windows
- Install NodeJS. The installer isn't perfect, you might need to add it manually to your windows PATH variables.
- Install mdoc (npm install mdoc).
- Write some Markdown.
- Run mdoc on it - mdoc --title MyDocs -i InputDir -o OutputDir
- Done.
Note - you need to view your generated docs via a webserver if you wanna get the automatic sidebar action (it loads in via JS).