Dr. Jeannot Muller

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

Install Hombrew (https://brew.sh)

Paste the below code in a macOS terminal session:

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

Installing Python for macOS (https://www.python.org/downloads/)

Please chose your appropriate version for macOS at https://www.python.org/downloads/ and install the package

A better way is to follow this great installation guide: https://opensource.com/article/19/5/python-3-default-mac

This will ensure you are building up a clean environment.

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