GointermediatecliAI generated

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

  1. 01

    Walk the source directory

    ~1.5h

    Traverse a source directory and collect all Markdown files using filepath.Walk.

  2. 02

    Convert Markdown to HTML

    ~1.5h

    Convert each file's content to HTML using a Markdown parsing library.

  3. 03

    Apply a layout template

    ~2h

    Wrap converted content in a shared HTML layout, reading front-matter metadata like title and date.

  4. 04

    Generate an index page

    ~1.5h

    Build an index page listing all posts sorted by publish date.

  5. 05

    Add watch mode

    ~2h

    Add a --watch flag that rebuilds the site automatically when source files change.

Resources

Ready to build this?

Get a GitHub repo and start building. Your AI reviewer checks each step as you go.

~8.5h · 5 steps

Tech stack

blackfridayhtml/templateflag