March 23, 2026

Starting the blog in Markdown

The first post in the archive shows how Markdown source now turns into the static HTML served by the site.

This site now keeps blog posts in Markdown under content/posts/ and generates static HTML into the repository root for GitHub Pages.

What changed

  • New posts can be written in Markdown instead of hand-authoring a full HTML page.
  • blog/index.html can surface published posts automatically.
  • The generated pages still use the shared header, footer, and stylesheet.

Local workflow

  • Add a Markdown file with front matter.
  • Run just generate.
  • Preview the site with python3 -m http.server 8000.

Archive

More writing

Return to the Blog index