markdown "sync" framework

An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex.

Write markdown locally, run npm run sync (dev) or npm run sync:prod (production), and content appears instantly across all connected browsers. Built with React, Convex, and Vite. Optimized for AEO, GEO, and LLM discovery.

How publishing works: Write posts in markdown, run npm run sync for development or npm run sync:prod for production, and they appear on your live site immediately. No rebuild or redeploy needed. Convex handles real-time data sync, so all connected browsers update automatically.

Sync commands:

Sync command scripts are located in scripts/ (sync-posts.ts, sync-discovery-files.ts).

Development:

• npm run sync - Sync markdown content
• npm run sync:discovery - Update discovery files (AGENTS.md, llms.txt)
• npm run sync:all - Sync content + discovery files together

Production:

• npm run sync:prod - Sync markdown content
• npm run sync:discovery:prod - Update discovery files
• npm run sync:all:prod - Sync content + discovery files together

Export dashboard content:

• npm run export:db - Export dashboard posts/pages to content folders (development)
• npm run export:db:prod - Export dashboard posts/pages (production)

How versioning works: Markdown files live in content/blog/ and content/pages/. These are regular files in your git repo. Commit changes, review diffs, roll back like any codebase. The sync command pushes content to Convex.

# Edit, commit, sync
git add content/blog/my-post.md
git commit -m "Update post"
npm run sync        # dev
npm run sync:prod   # production

Documentation

Full documentation is available at [markdown.fast/docs](https://www.markdown.fast/docs)

Guides

• Setup Guide - Complete fork and deployment guide
• Fork Configuration Guide - Automated or manual fork setup
• Dashboard Guide - Content management and site configuration
• MCP Server - AI tool integration for Cursor and Claude Desktop
• AgentMail Setup - Newsletter and contact form integration
• WorkOS Setup - Legacy authentication mode (use auth.mode: "workos" in siteConfig)

AI Development Tools

The project includes documentation optimized for AI coding assistants: