sitemd

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

git clone https://github.com/sitemd-cc/sitemd.git my-site
cd my-site
./sitemd/install
./sitemd/sitemd launch

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

AI Integration

sitemd includes an MCP server that works with Claude Code, Gemini CLI, and Codex CLI. The `.mcp.json` at the project root configures it automatically.

**Available MCP tools:** page management, content generation, site status, settings, deploy, clone, and more.

Project Structure

my-site/
  sitemd/          ← Product directory
    sitemd         ← Compiled binary
    install        ← Bootstrap script (downloads binary)
    pages/         ← Your markdown content
    settings/      ← Site configuration (YAML frontmatter)
    theme/         ← CSS and HTML templates
    media/         ← Images and assets
    site/          ← Built output (gitignored)
  site.md          ← Setup instructions

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

...