Showcase · Computer Science

Static Site Compiler

A markdown-to-HTML compiler with an incremental build graph, written to learn parsing and dependency tracking from first principles.

Discipline
Computer Science
Role
Systems engineering
Duration
7 weeks
Year
2026

Problem

Off-the-shelf generators rebuild the world on every change. The goal was to understand — by building it — how a dependency graph makes rebuilds proportional to the edit.

Approach

  1. 01Hand-written tokenizer and recursive-descent parser, no parser generator.
  2. 02Content-addressed cache keyed on source hash plus resolved dependencies.
  3. 03Dependency edges recorded for includes, links and shared templates.
  4. 04Fuzzed against a reference implementation for output equivalence.