This is a lightweight static site generator written in Python. It converts Markdown files from the content/ directory into styled HTML files using a custom template.html, and outputs them into the docs/ directory. It also copies over static assets like images and CSS from the static/ folder.
content/— Source Markdown contentstatic/— Static assets (e.g., CSS, images)template.html— HTML template with placeholdersdocs/— Output folder for the generated sitesrc/— Source code and tests
python3 src/main.pyTo clean and rebuild:
./main.sh## 🧪 Running Tests
```bash
python3 -m unittest discover src/📌 Features:
- Recursive page generation from nested folders
- Supports headings, lists, blockquotes, and inline Markdown
- Simple templating for dynamic title and content insertion
- Asset copying for deployment-ready builds
This is a personal project built to better understand file I/O, recursion, and A simple Markdown to HTML parser and static site generator built using Python.- Python 3
- Markdown (custom parser)
- HTML/CSS (for templating and styling)
- Shell scripts (for automation)
A Markdown file at:
content/blog/glorfindel/index.md
Will be converted into:
docs/blog/glorfindel/index.html
With all images and styles properly linked from the static/ folder.
✨ *From guided beginnings to independent creation* ✨
🐍 *Powered by Python’s simplicity*
🌱 *Rooted in curiosity, grown through code*