About Markdown Site
Markdown Site is an open-source publishing framework for developers and AI agents who want to ship websites, documentation or blogs from plain markdown files. Content is written locally and synced from the terminal, and it becomes available right away to browsers as well as to LLMs and agents.
The stack is React, Vite and Convex, with Convex handling real-time data sync so connected browsers update without a rebuild or redeploy. Separate sync commands push posts, wiki pages and generated discovery files such as AGENTS.md, CLAUDE.md and llms.txt to development or production, and an export command pulls dashboard-authored posts and pages back into the content folders. The project says it is optimized for AEO, GEO and LLM discovery.
Markdown files live in content/blog and content/pages as regular files in your git repository, so versioning follows normal git workflows. The project is released under the MIT license and is built on Convex and Netlify. Wiki content can be synced into a specific knowledge base.
Key features
- Markdown posts synced from the terminal
- Real-time updates without rebuilding or redeploying
- Wiki and knowledge-base page syncing
- Generated llms.txt, AGENTS.md and CLAUDE.md files
- Dashboard content export back to markdown
- Git-versioned content folders
Good fit for
- →Developer blogs and documentation sites
- →Content that AI agents need to read
- Built with
- TypeScript
- Tags
- markdown
- cms
- convex
- react
- vite
- llms-txt
- docs
- blog
Markdown Site: questions and answers
- What is Markdown Site used for?
- Markdown Site is an MIT-licensed publishing framework on Convex, React and Vite that syncs markdown from the terminal to a live site readable by browsers and AI agents. It is a good fit for developer blogs and documentation sites, and content that AI agents need to read.
- Is Markdown Site open source?
- Yes. Markdown Site is open source under the MIT licence. Its source code is on GitHub at waynesutton/markdown-site and is written mainly in TypeScript.
- Is Markdown Site free?
- Yes. Markdown Site is open source, so the software itself is free to use.
- Can I self-host Markdown Site?
- Yes. Markdown Site can be self-hosted on your own server or infrastructure.
- What are some alternatives to Markdown Site?
- Similar open-source tools in the CMS category include TinaCMS, Bludit and ReactPress. SaaS products in the same category include BlogBowl, Blogsitefy and Contza.
- Is Markdown Site actively maintained?
- The most recent commit to Markdown Site was on 20 May 2026. The project has 629 stars on GitHub.
Open-source alternatives to Markdown Site
See all
TinaCMS
CMS
TinaCMS is the leading open-source headless CMS that supports Markdown and Visual Editing.
Apache-2.0vs Storyblok★ 14k
Bludit
CMS
Simple, Fast, Secure, Flat-File CMS
MITvs Blogger★ 1.5k
ReactPress
CMS
🔥 ReactPress - The publishing system for React developers.(面向 React 开发者的发布系统。)Demo:https:
MIT★ 761
Cromwell CMS
CMS
WordPress-like CMS for Next.js websites
MITvs Contentstack★ 753
Hugo
CMS
The world’s fastest framework for building websites.
Apache-2.0★ 90k
Zola
CMS
A fast static site generator in a single binary with everything built-in. https://www.getz
EUPL-1.2★ 17k
SaaS alternatives to Markdown Site
See all
BlogBowl
CMS
Open-source blog and newsletter management platform
SaaS
Blogsitefy
CMS
Create SEO-optimized blogs on your own domain without relying on a third-party platform
SaaS
Contza
CMS
Developer-first CMS that adds visual content editing to a website
SaaS
Voog
CMS
Website builder with online store and multilingual site features from Estonia
SaaS
1FoodMenu
CMS
One-page website builder for restaurants and food trucks with menu, hours and contact info
SaaSABHUB
CMS
No-code website builder and content management system for small and mid-size wineries
SaaS

