How to install MkDocs on macOS

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 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