MkDocs is a fast, simple and downright gorgeous static site generator that’s geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file.

The following guide is showing the installation under macOS. More information can be found at: https://www.mkdocs.org

Paste the below code in a macOS terminal session:

/usr/bin/ruby -e "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/master/install)](https://raw.githubusercontent.com/Homebrew/install/master/install%29)

Installing pip

If you’re using a recent version of Python, the Python package manager, pip, is most likely installed by default. However, you may need to upgrade pip to the lasted version:

pip install --upgrade pip

If you need to install pip for the first time, download get-pip.py. Then run the following command to install it:

sudo python get-pip.py sudo pip install matplotlib

Installing MkDocs

sudo pip install mkdocs

Getting Started

mkdocs new my-project