public/raw/home-intro.md

# Home Intro

---
Type: page
Date: 2026-01-08
---

An open-source publishing framework built for AI agents and developers to ship **[docs](/docs)**, or **[blogs](/blog)** or **[websites](/)**.

Write markdown, sync from the terminal. **[Fork it](https://github.com/waynesutton/markdown-site)**, 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, run `npm run sync`, content syncs everywhere.

**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			`# Home Intro`

			`---`
			`Type: page`
Canonical URL fix for search engines (GitHub Issue #6) and other seo fixes" 2026-01-07 21:48:41 -08:00			`Date: 2026-01-08`
feat: add blog heading styles to home intro content 2025-12-28 18:09:57 -08:00			`---`

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			`An open-source publishing framework built for AI agents and developers to ship [docs](/docs), or [blogs](/blog) or [websites](/).`
feat: add blog heading styles to home intro content 2025-12-28 18:09:57 -08:00
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			`Write markdown, sync from the terminal. [Fork it](https://github.com/waynesutton/markdown-site), 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
			File-based publishing — Write markdown locally, run `npm run sync`, content syncs everywhere.

			`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.`

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			`Real-time team sync — Multiple developers run npm run sync from different machines.`

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			`Sync Commands - Sync discovery commands to update AGENTS.md, CLAUDE.md, and llms.txt`

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.`