🔨 MarkSmith

A Markdown-to-HTML static site generator. Convert your Markdown files into clean, responsive HTML pages with syntax highlighting, YAML front matter, and dark mode support.

---

✨ Features

• 📝 YAML Front Matter — Title, date, tags, description, custom fields
• 🎨 Syntax Highlighting — Code blocks with Pygments
• 📑 Table of Contents — Auto-generated with permalink anchors
• 🌙 Dark Mode — Automatic via prefers-color-scheme
• 🔄 Live Reload — Dev server watches for changes and rebuilds
• 📱 Responsive — Clean, modern template that works everywhere
• ⚡ Fast — No heavy template engine, just clean Python

🚀 Quick Start

git clone https://github.com/sofia-willow/marksmith.git
cd marksmith
pip install -e .

Create a sample project

python -m marksmith init

Build your site

python -m marksmith build content -o dist

Dev server with live reload

python -m marksmith serve content -p 8080

📖 Front Matter

---
title: My Blog Post
date: 2026-03-17
tags: [python, web, tutorial]
description: A guide to building static sites
draft: false
---

# Your content here...

🏗️ Architecture

marksmith/
├── __init__.py      # Package metadata
├── __main__.py      # python -m marksmith entry point
├── cli.py           # CLI commands: build, serve, init
├── converter.py     # Markdown parsing, front matter, HTML conversion
├── models.py        # Page dataclass
├── server.py        # Dev server with watchdog file monitoring
└── templates.py     # Embedded HTML/CSS template with dark mode

📝 License

MIT License — see LICENSE for details.

---

Built by Sofia Willow