codeseed
Sign in
Explore Projects
TypeScriptbeginnercliAI generated

Markdown to Static Site Generator

Build a CLI tool that converts a folder of Markdown files into a static HTML site with templated layouts and navigation. Learners practice Node.js file-system APIs, typed build configuration, and Markdown parsing.

Estimate
~8.5h
Steps
6
Completed by
0
Proposed by
codeseed.app

Node.js · markdown-it

Sign in to claim this project

Project roadmap

  1. 01

    Set up the project

    ~1h

    Initialize a Node.js project with TypeScript and a tsconfig targeting Node.

  2. 02

    Read Markdown files

    ~1.5h

    Read all Markdown files from an input directory recursively.

  3. 03

    Parse Markdown to HTML

    ~1.5h

    Convert each file's content to HTML using markdown-it.

  4. 04

    Apply an HTML template

    ~2h

    Wrap generated HTML in a shared layout template with navigation links.

  5. 05

    Write output files

    ~1.5h

    Write the generated pages to a dist folder, preserving the input directory structure.

  6. 06

    Add CLI flags

    ~1h

    Support command-line flags for specifying input and output directories.

Resources

Ready to build this?

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

~8.5h · 6 steps

Tech stack

Node.jsmarkdown-it