feat(www): add Markdown negotiation and LLM discovery

[KyleTryon]

Cliparr now serves build-generated Markdown when clients request Accept: text/markdown, while browsers continue receiving HTML. Conversion preserves rendered MDX commands, tables, and callouts without a paid conversion service.

• Serve direct .md URLs such as /docs.md and /docs/getting-started.md through internal rewrites, with no redirects. The homepage uses /index.md.
• Point Markdown canonical headers to the corresponding HTML pages; publish alternate links and a contextual llms.txt guide. Keep HTML URLs in the sitemap.
• Support quality-aware negotiation, HEAD, conditional requests, and representation-safe cache headers.
• Return a timeline-themed HTML 404 for browsers and a compact Markdown 404 with recovery links for Markdown requests. Both preserve HTTP 404; error pages are noindex and do not advertise canonical or alternate pages.
• Keep the 404 illustration CSS-only, responsive, and reduced-motion-aware, with keyboard-accessible recovery links and no dependency on JavaScript for recovery.
• Declare search=yes, ai-input=yes, and ai-train=yes in robots.txt and Markdown content signals.

Preview URL change: nested /…/index.md URLs are replaced by /….md, without compatibility aliases. Generated file locations remain internal.

Page requests, including direct Markdown and arbitrary missing pages, invoke the Worker and count toward Workers usage. Bundled assets, public images/media, scripts, manifests, XML, and text files retain asset-only routing.

Validation: full pnpm preflight and pnpm build:web passed using Node 24. Local Cloudflare checks covered all 24 generated pages, HTML and Markdown negotiation, canonical headers, HEAD, 304 responses, clean 404s, and recovery links. Browser checks covered desktop/mobile layouts, reduced motion, keyboard access, no-JavaScript recovery, and real navigation requests. No production deployment performed.

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	cliparr-web	a5736f2	Commit Preview URL Branch Preview URL	Sep 20 2026, 03:20 PM