Markdown Sitegen

Back to Projects


This was an attempt to create a Static Site Generator (SSG) using Python.


Sitegen 1: Converting Markdown into a Blog (kinda)

Getting started with generating a blog website from a bunch of Markdown files in an Obsidian vault.

11 months ago • January 29, 2023

Sitegen 2: Adding jinja2 templates

Quick video about progress on the markdown-sitegen package

11 months ago • February 1, 2023

Sitegen 3: jumping thru hoops for CSS

Let's add some basic styling - to do that, we'll need to (1) copy static files and (2) pass in some sort of relative path for the templates to use as a reference point.

11 months ago • February 3, 2023

Sitegen 4: Adding Posts Index

Added posts index, added config file for site title, and other cool stuff

11 months ago • February 5, 2023

Sitegen 5: Parsing the date, and more

We fix page titles, parse date, sort by date, and limit to 5 posts on the index page. Then we add a better navbar with links and create the Archive page.

11 months ago • February 7, 2023

Sitegen 6: Adding prev/next post buttons

Buckle up, it's time to add next and previous buttons to our posts. We also add a check for multiple posts with the same path AND add year headers to the Archive page.

11 months ago • February 9, 2023

Sitegen 7: Adding Doodads

We add (1) a list of authors, if the post specifies it and (2) a YouTube player, if the post specifies a YouTube ID.

11 months ago • February 11, 2023

Sitegen 8: kidney reveal / Adding images

In this video, we reveal the true kidney, along with an imposter bean.

11 months ago • February 13, 2023

Sitegen 9: Adding colorful codeblocks

In this video, we add colorful syntax highlighting to our blog's codeblocks! Thankfully it was simple - just had to leverage existing plugins for the Markdown package, and generate CSS using Pygmentize

11 months ago • February 15, 2023

Sitegen 10: Footer & Post Summaries

In this one, we add a footer for the site, as well as a blog feed page with post summaries (instead of dumping the entire post in there).

10 months ago • February 20, 2023

Sitegen 11: Adding Pagination

We add pagination to our static site generator.

10 months ago • February 22, 2023

Sitegen 12: Logo, Footer, Styling

We add logo support, fix the footer, and improve the overall appearance - albeit only slightly.

10 months ago • February 24, 2023

Sitegen 13: Adding redirects

We add redirects

10 months ago • March 3, 2023