Document your application with MkDocs

Recently I’ve been given a task to document our web applications. In this post we will go over how to do it with MkDocs.

Photo by STIL on Unsplash

Mkdocs is based in Python. So you need to install Mkdocs with “pip” in order to implement.

pip install mkdocs

We have some built-in themes in Mkdocs. But we can customize the themes we would like to. The theme folder will be in the same level with the docs level.

First we need to create the mkdocs.yml file.

Here we define the theme directory we will use, which is “cinder” dir.

The navigation links with multiple levels.

“Cinder” directory will consist of html, yml files with js or css files if needed.

To run the documentation page, simply put:

mkdocs serve

There we go.

Documentation page with Mkdocs

The full source code can be found in here.

Thanks for reading my post.


A passionate automation engineer who strongly believes in “A man can do anything he wants if he puts in the work”.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store