sitemd

Websites from Markdown. Built for AI coding assistants.

sitemd turns a folder of markdown files into a production-ready static website with navigation, search, themes, forms, analytics, SEO, and more — all configured through simple settings files.

Quick Start

npm install -g @sitemd-cc/sitemd
sitemd init my-site
cd my-site
npm install
sitemd launch

Open the dev server URL to see your site (port configured in sitemd/settings/build.md, default 4747).

AI Integration

sitemd ships a single skill for Claude Code and other AI coding agents. The .claude/skills/sitemd/ and .agents/skills/sitemd/ directories route agent intent to CLI commands.

All operations go through the sitemd CLI — run sitemd help for the full command list.

Project Structure

my-site/
  sitemd/          <- Product directory
    pages/         <- Your markdown content
    settings/      <- Site configuration (YAML frontmatter)
    theme/         <- CSS and HTML templates
    media/         <- Images and assets
    site/          <- Built output (gitignored)
  site.md          <- Project context for AI agents
  .claude/skills/sitemd/  <- Claude Code skill
  .agents/skills/sitemd/  <- Generic agent skill

Features

• Pages from Markdown — Write content in .md files with frontmatter
• Navigation — Header, footer, sidebar groups, dropdowns, search
• Themes — Light, dark, paper modes with full color customization
• Cards, Embeds, Galleries — Rich content components
• Forms — Multi-page forms with conditional logic and webhooks
• Analytics — Google Analytics, Plausible, Fathom, PostHog, and more
• SEO — OG images, sitemaps, structured data, AI crawler control
• User Auth — Supabase, Firebase, Clerk, Auth0, custom API
• Dynamic Data — Connect to Supabase, Firebase, Airtable, REST APIs
• Deploy — sitemd deploy to Cloudflare, or host site/ anywhere

CLI Commands

sitemd launch              # Start dev server
sitemd deploy              # Build and deploy
sitemd status              # Project overview
sitemd pages               # List pages
sitemd pages create <slug> # Create a page
sitemd clone <url>         # Clone a website
sitemd auth login          # Log in to your account
sitemd secret set K=V      # Set a secret
sitemd config setup        # Configure services
sitemd update              # Update to latest version

Documentation

Full docs at sitemd.cc/docs

License

Elastic License 2.0