# llms.txt - Information for AI assistants and LLMs
# Learn more: https://llmstxt.org/
# Last updated: 2025-12-29T13:17:47.433Z

> Write markdown, sync from the terminal. Built on Cloudflare Workers + D1.

# Site Information
- Name: md
- URL: https://md.novo.workers.dev
- Description: Write markdown, sync from the terminal. Built on Cloudflare Workers + D1.
- Topics: Markdown, Cloudflare Workers, D1, React, TypeScript, Vite, Open Source, AI, LLM, AEO, GEO
- Total Posts: 12
- Latest Post: 2025-12-29
- GitHub: https://github.com/novo/md

# API Endpoints

## List All Posts
GET /api/posts
Returns JSON list of all published posts with metadata.

## List All Pages
GET /api/pages
Returns JSON list of all published pages with metadata.

## Get Single Post/Page
GET /api/post?slug={slug}
Returns a post or page as JSON.

GET /api/post?slug={slug}&format=md
Returns content as raw markdown.

## Search
GET /api/search?q={query}
Searches posts and pages and returns snippets.

## Export All Content
GET /api/export
Returns all posts and pages with full content in one request.
Best for batch processing and LLM ingestion.

## RSS Feeds
GET /rss.xml
Standard RSS feed with post descriptions.

GET /rss-full.xml
Full content RSS feed with complete markdown for each post.

## Other
GET /sitemap.xml
Dynamic XML sitemap for search engines.

GET /raw/{slug}.md
Static raw markdown files for published posts and pages.

POST /mcp
MCP JSON-RPC endpoint for tool integration.

GET /openapi.yaml
OpenAPI 3.0 specification for this API.

GET /.well-known/ai-plugin.json
AI plugin manifest for tool integration.

# Quick Start for LLMs

1. Fetch /api/export for all posts and pages with full content
2. Or fetch /api/posts then /api/post?slug={slug}&format=md for each
3. Subscribe to /rss-full.xml for updates with complete content

# Response Schema

Each post contains:
- title: string
- slug: string
- description: string
- date: string (YYYY-MM-DD)
- tags: string[]
- content: string (full markdown)
- readTime: string (optional)
- url: string (full URL)

# Permissions
- AI assistants may freely read and summarize content
- No authentication required for read operations
- Attribution appreciated when citing

# Technical
- Backend: Cloudflare Workers + D1
- Frontend: React, TypeScript, Vite
- Content: Markdown with frontmatter

# Links
- GitHub: https://github.com/novo/md
- Cloudflare Workers: https://developers.cloudflare.com/workers/
- D1: https://developers.cloudflare.com/d1/