Parsing on Ikwuka Okoye

Converting Markdown Blocks into Semantic HTML

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

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.

A block is a logical unit of Markdown content.

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

One of the easiest mistakes to make when building a Markdown-to-HTML converter is to think of the problem as string replacement.

Replace **text** with <strong>text</strong>.

Replace *text* with <em>text</em>.

Replace headings with <h1>.

At first, this seems sufficient.

It quickly becomes difficult once documents contain nested structures.

A more robust approach is to introduce an intermediate representation between Markdown and HTML.

Thu, 16 Jul 2026 00:00:00 +0000

A Python static-site generator exploring parsing, AST-like structures, Markdown transformation, HTML generation, and clean software architecture.