Markdown Static Site Generator CLI
A command-line tool in Go that converts a directory of Markdown files into a styled static HTML website, complete with templating and an index page. Learners practice file-tree traversal, Markdown-to-HTML conversion, and Go templating.
- Estimate
- ~8.5h
- Steps
- 5
- Completed by
- 0
- Proposed by
- codeseed.app
blackfriday · html/template · flag
Project roadmap
- 01
Walk the source directory
~1.5hTraverse a source directory and collect all Markdown files using filepath.Walk.
- 02
Convert Markdown to HTML
~1.5hConvert each file's content to HTML using a Markdown parsing library.
- 03
Apply a layout template
~2hWrap converted content in a shared HTML layout, reading front-matter metadata like title and date.
- 04
Generate an index page
~1.5hBuild an index page listing all posts sorted by publish date.
- 05
Add watch mode
~2hAdd a --watch flag that rebuilds the site automatically when source files change.
Resources
- DocsGo Documentation
Ready to build this?
Get a GitHub repo and start building. Your AI reviewer checks each step as you go.
Tech stack