MkDocs is an open source Python tool for lowering the barrier to writing documentation. The goal is relatively simple and focused, we want to make it easier to write high quality prose based documentation.
Originally started by Tom Christie, I took over maintenance and development about 6 months ago. Since then there has been a number of interesting changes, I want to start writing about these, but first this post will introduce the project for those unfamiliar with it.
The MkDocs documentation takes you through the process of getting started in detail. This is the super quick version.
Start a new project with
mkdocs new my_project. This will create a new directory called my_project or add a mkdocs config to an existing directory. It will also create a index.md file within a docs dir.
Move into the directory you provided above and run
Now open up the index.md file and start editing, when you save, the browser should automatically refresh and show the new changes.
I plan to follow up this post and share some of the changes and improvements coming in MkDocs. Both from a technical and users point of view.