sitemd Docs

Everything you need to build your site with sitemd.

What is sitemd?

sitemd is a static site generator / website building tookit for AI coding agents. You write content in markdown files, your agent handles the build, and you get a fast, production-ready website. It works with Claude Code, Codex, Cursor, Gemini, OpenClaw, VS Code, and any MCP-capable agent.

There's no framework to learn. No config files to wrestle with. You describe what you want in plain English, and your agent makes it happen — because every convention in sitemd is designed for it.

What is markdown?

Markdown is a plain-text formatting language. You write # for headings, ** for bold, - for lists, and [text](url) for links — then a build tool turns it into HTML. No database, no visual editor, no proprietary format. Open a .md file in any text editor and you can read it immediately.

AI coding agents produce markdown by default. When your site content is markdown, there's no conversion layer between what the agent generates and what your site displays. The agent writes a file, sitemd builds it, and you have a page.

Read What Is Markdown and Why Do Agents Love It? for the full story on why markdown is the ideal format for AI-built websites.

Quick start

  1. Open your project in any AI coding agent
  2. The agent reads the context file and discovers the MCP server automatically
  3. Start writing markdown in pages/
  4. Ask your agent to build your site
  5. Preview locally at localhost:4747

See Getting Started for detailed setup instructions per agent, or Agent Onboarding for how the system teaches your agent everything it needs.

How the docs are organized

Getting Started — Installation, setup, and your first page.

Pages & Content — How pages work, frontmatter reference, sections.

Themes — Light, dark, and paper modes. Customizing the look.

Live Build Sync — File watching, theme sync, live reload.

Groups — Page collections for sidebars, header dropdowns, and footer columns.

Navigation — Header nav, dropdown groups, buttons, and auto-scaffolding.

Buttons & Links — Universal buttons, anchor links, and inline anchors.

Embeds — Embed videos, images, tweets, and more with one line.

Colors — Named color palette for buttons and highlights.

MCP Server — Programmatic access to pages, settings, and groups from any AI agent.