diff --git a/docs/how-to-catch-outgoing-emails-locally.md b/docs/how-to-catch-outgoing-emails-locally.md
index 2bca0a89ea..925c81822d 100644
--- a/docs/how-to-catch-outgoing-emails-locally.md
+++ b/docs/how-to-catch-outgoing-emails-locally.md
@@ -1,23 +1,19 @@
> **Note:** This is an **optional** step and is required only when working with email workflows
+- [Introduction](#introduction)
+- [Installing MailHog](#installing-mailhog)
+- [Using MailHog](#using-mailhog)
+- [Useful Links](#useful-links)
+
## Introduction
Some email workflows, like updating a user's email, requires the back-end api-server to send outgoing emails. An alternative to using an email service provider to send actual email messages, Mailhog is a developer tool for email testing that will catch the email messages sent by your freeCodeCamp instance.
## Installing MailHog
-MailHog can be installed on macOS, Windows and Linux.
+MailHog can be installed on macOS, Windows and Linux or used via Docker
-- [Introduction](#introduction)
-- [Installing MailHog](#installing-mailhog)
- - [Installing MailHog with Docker](#installing-mailhog-with-docker)
- - [Installing MailHog on macOS](#installing-mailhog-on-macos)
- - [Installing MailHog on Windows](#installing-mailhog-on-windows)
- - [Installing MailHog on Linux](#installing-mailhog-on-linux)
-- [Using MailHog](#using-mailhog)
-- [Useful Links](#useful-links)
-
-### Installing MailHog with Docker
+Installing MailHog with Docker
If you have Docker installed then you can use
@@ -25,7 +21,7 @@ If you have Docker installed then you can use
docker run -d --name mailhog --rm mailhog/mailhog
```
-to start MailHog in the background and
+to start MailHog in the background and
```bash
docker stop mailhog
@@ -34,8 +30,9 @@ docker stop mailhog
to stop it.
When the installation completes, you can start [using MailHog](#using-mailhog).
+
-### Installing MailHog on macOS
+Installing MailHog on macOS
Install MailHog on macOS with [Homebrew](https://brew.sh/):
@@ -47,8 +44,9 @@ brew services start mailhog
The above commands will start a mailhog service in the background.
When the installation completes, you can start [using MailHog](#using-mailhog).
+
-### Installing MailHog on Windows
+Installing MailHog on Windows
Download the latest version of MailHog from [MailHog's official repository](https://github.com/mailhog/MailHog/releases). Locate and click on the link for your Windows version (32 or 64 bit) and a .exe file will be downloaded to your computer.
@@ -57,8 +55,9 @@ When the download completes, click to open the file. A Windows firewall notifica
Close MailHog by closing the command prompt window. To start MailHog again, click on the MailHog executable (.exe) file that was downloaded initially - it is not necessary to download a new MailHog installation file.
Start [using MailHog](#using-mailhog).
+
-### Installing MailHog on Linux
+Installing MailHog on Linux
First, install [Go](https://golang.org).
@@ -97,6 +96,7 @@ mailhog
```
Start [using MailHog](#using-mailhog).
+
## Using MailHog