content/pages/home.md

---
title: "Home Intro"
slug: "home-intro"
published: true
showInNav: false
order: -1
textAlign: "left"
---

The open-source markdown publishing framework for developers and AI agents to ship **[docs](/docs)**, or **[blogs](/blog)** or **[websites](/)** that's always in sync.

**[Fork it](https://github.com/waynesutton/markdown-site)** or **<span class="copy-command">npx create-markdown-sync my-site</span>**, customize it, ship it.

<!-- This is a comments
Your content is instantly available to browsers, LLMs, and AI
agents. -->

## Features

**AI agent integration** — API endpoints, raw markdown files, skills.md and MCP server included.

**File-based publishing** — Write markdown locally, content syncs everywhere with version control.

**URL content import** — Import urls to scrape any webpage into markdown with Firecrawl.

**Newsletter automation** — Built-in subscription forms and admin dashboard powered by AgentMail.

**Multiple output formats** — JSON via API endpoints, raw .md files, and RSS feeds.

**Real-time team sync** — Multiple developers run npm run sync from different machines.

**Sync Commands** - Sync discovery commands to update AGENTS.md, CLAUDE.md, and llms.txt

**Semantic search** - Find content by meaning, not just keywords.

**Ask AI** - Chat with your site content. Get answers with sources.

```

```
feat: add blog heading styles to home intro content 2025-12-28 18:09:57 -08:00			`---`
			`title: "Home Intro"`
			`slug: "home-intro"`
			`published: true`
			`showInNav: false`
			`order: -1`
			`textAlign: "left"`
			`---`

new: npx create-markdown-sync CLI , ui , related post thumbnails features 2026-01-10 23:46:08 -08:00			`The open-source markdown publishing framework for developers and AI agents to ship [docs](/docs), or [blogs](/blog) or [websites](/) that's always in sync.`
feat: add blog heading styles to home intro content 2025-12-28 18:09:57 -08:00
npm package prd added 2026-01-11 00:23:04 -08:00			`[Fork it](https://github.com/waynesutton/markdown-site) or <span class="copy-command">npx create-markdown-sync my-site</span>, customize it, ship it.`
feat: add blog heading styles to home intro content 2025-12-28 18:09:57 -08:00
			`<!-- This is a comments`
			`Your content is instantly available to browsers, LLMs, and AI`
			`agents. -->`

			`## Features`

feat: add CLAUDE.md and skills documentation Created CLAUDE.md for Claude Code instructions and .claude/skills/ directory with frontmatter, convex, and sync skill files. Updated sync-discovery-files.ts to auto-update CLAUDE.md during sync. 2025-12-30 12:03:06 -08:00			`AI agent integration — API endpoints, raw markdown files, skills.md and MCP server included.`
feat: add blog heading styles to home intro content 2025-12-28 18:09:57 -08:00
fix: Hide scrollbars on docs layout while preserving scroll, update about page for dashboard workflow 2026-01-10 00:15:28 -08:00			`File-based publishing — Write markdown locally, content syncs everywhere with version control.`
feat: add blog heading styles to home intro content 2025-12-28 18:09:57 -08:00
			`URL content import — Import urls to scrape any webpage into markdown with Firecrawl.`

			`Newsletter automation — Built-in subscription forms and admin dashboard powered by AgentMail.`

			`Multiple output formats — JSON via API endpoints, raw .md files, and RSS feeds.`

			`Real-time team sync — Multiple developers run npm run sync from different machines.`
feat: add CLAUDE.md and skills documentation Created CLAUDE.md for Claude Code instructions and .claude/skills/ directory with frontmatter, convex, and sync skill files. Updated sync-discovery-files.ts to auto-update CLAUDE.md during sync. 2025-12-30 12:03:06 -08:00
			`Sync Commands - Sync discovery commands to update AGENTS.md, CLAUDE.md, and llms.txt`
feat: Add semantic search with vector embeddings Add vector-based semantic search to complement keyword search. Users can toggle between "Keyword" and "Semantic" modes in the search modal (Cmd+K, then Tab to switch). Semantic search: - Uses OpenAI text-embedding-ada-002 (1536 dimensions) - Finds content by meaning, not exact words - Shows similarity scores as percentages - ~300ms latency, ~$0.0001/query - Graceful fallback if OPENAI_API_KEY not set New files: - convex/embeddings.ts - Embedding generation actions - convex/embeddingsQueries.ts - Queries/mutations for embeddings - convex/semanticSearch.ts - Vector search action - convex/semanticSearchQueries.ts - Result hydration queries - content/pages/docs-search.md - Keyword search docs - content/pages/docs-semantic-search.md - Semantic search docs Changes: - convex/schema.ts: Add embedding field and by_embedding vectorIndex - SearchModal.tsx: Add mode toggle (TextAa/Brain icons) - sync-posts.ts: Generate embeddings after content sync - global.css: Search mode toggle styles Documentation updated: - changelog.md, TASK.md, files.md, about.md, home.md Configuration: npx convex env set OPENAI_API_KEY sk-your-key Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> Status: Ready to commit. All semantic search files are staged. The TypeScript warnings are pre-existing (unused variables) and don't affect the build. 2026-01-05 18:30:48 -08:00
Canonical URL fix for search engines (GitHub Issue #6) and other seo fixes" 2026-01-07 21:48:41 -08:00			`Semantic search - Find content by meaning, not just keywords.`

			`Ask AI - Chat with your site content. Get answers with sources.`
new: npx create-markdown-sync CLI , ui , related post thumbnails features 2026-01-10 23:46:08 -08:00
			```

			```