Publish a Static Website in a Day with MkDocs and Netlify

Sean Stewart
Jan 13, 2020 · 6 min read
Image for post
Image for post

Intro

Background

Pre-Reqs

Create the Source

Set Up Your Environment

Create your project directory and initialize with poetry
Create a new virtualenv and install the dependencies

Initialize MkDocs

Initialize the mkdocs project scaffolding and turn on the server

Customize and Configure Your Site

Read the Docs

Add Some Extras

Deploy Your Site on Netlify

Bonus

Add a Feed for Your Medium Posts

Add a Contact Form

Wrap Up

The Startup

Medium's largest active publication, followed by +773K people. Follow to join our community.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

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