Web Development on Ikwuka Okoye

Building a Static Site Generator in Python: From Markdown to HTML

Mon, 10 Aug 2026 00:00:00 +0000

Building a Static Site Generator in Python: From Markdown to HTML

A static site generator looks simple from the outside.

You write some Markdown, run a command, and HTML files appear in an output directory.

The interesting engineering work happens between those two points.

Building a static site generator from scratch is a useful exercise because it exposes several concepts that are normally hidden behind frameworks and libraries: parsing, intermediate representations, tree structures, rendering, filesystem operations, and deterministic builds.

Converting Markdown Blocks into Semantic HTML

Mon, 10 Aug 2026 00:00:00 +0000

Converting Markdown Blocks into Semantic HTML

Markdown documents are written as a continuous stream of text, but browsers consume structured HTML.

Bridging those two representations requires more than replacing a few characters.

A static site generator needs to understand the boundaries between blocks and determine what each block represents.

That was one of the central problems in my Static Site Generator project.

What Is a Markdown Block?

A block is a logical unit of Markdown content.

IkwukaoDotDev

Sun, 02 Aug 2026 00:00:00 +0000

A custom engineering portfolio focused on communicating technical work, engineering direction, and systems-building experience.