Quiet's Blog

A personal blog built with Markdown content and a Python build script that generates static HTML.

Writing Posts

Create a .md file with YAML frontmatter in the appropriate content/ subdirectory:

---
title: "My Post Title"
date: 2026-02-15
description: "A short summary of the post"
---

Post content in Markdown here...

Post Categories

Category	Directory	Filename Convention	Example
Regular	content/posts/	Any slug	content/posts/my-topic.md
Daily	content/daily/	YYYY-MM-DD.md	content/daily/2026-02-15.md
Weekly	content/weekly/	YYYY-WNN.md	content/weekly/2026-W07.md

Building

Requires uv:

uv run build.py

Output goes to dist/. Serve it with any static file server:

python3 -m http.server -d dist

Project Structure

content/          # Markdown source files
  posts/          # Regular posts
  daily/          # Daily posts
  weekly/         # Weekly posts
  about.md        # About page
templates/        # HTML templates with {{placeholder}} variables
static/           # Static assets (CSS)
build.py          # Build script (dependencies declared inline via PEP 723)
dist/             # Generated output (gitignored)