I have made it a habit to self-document the configuration settings (and idiosyncrasies) of programs I use, so that I can quickly reinstate them in case of a new OS installation, without having to chase manuals.

Currently, I do this in plain text format with a few symbols like brackets for special meaning. As the texts grow larger, I feel a need to switch to a more pleasant way to read and navigate them.

My current idea is to switch to "markdown" notation (or a fork of it) for the docs and then have a script build a tree of HTML pages from that. This way I could edit my files as before, but have something nicer for reading.

If you guys have any better suggestions, I'd love to hear them.