From 66c7f161bda115818f9141425ab6cadbe050b6b3 Mon Sep 17 00:00:00 2001 From: Wayne Sutton Date: Thu, 25 Dec 2025 00:47:40 -0800 Subject: [PATCH] update: homepage and descrption text --- AGENTS.md | 2 +- README.md | 2 +- content/blog/about-this-blog.md | 4 +++- .../blog/netlify-edge-excludedpath-ai-crawlers.md | 4 ---- content/pages/about.md | 6 ++++-- convex/http.ts | 4 ++-- convex/rss.ts | 2 +- index.html | 8 ++++---- public/llms.txt | 2 +- public/raw/about-this-blog.md | 4 +++- public/raw/about.md | 4 +++- public/raw/index.md | 2 +- public/raw/netlify-edge-excludedpath-ai-crawlers.md | 4 ---- scripts/sync-discovery-files.ts | 13 +++++-------- src/pages/Home.tsx | 10 ++++------ 15 files changed, 33 insertions(+), 38 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 30c8b4b..32bfda0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -22,7 +22,7 @@ Your content is instantly available to browsers, LLMs, and AI agents.. Write mar - **Total Posts**: 12 - **Total Pages**: 4 - **Latest Post**: 2025-12-25 -- **Last Updated**: 2025-12-25T08:31:10.580Z +- **Last Updated**: 2025-12-25T08:46:57.371Z ## Tech stack diff --git a/README.md b/README.md index c61be65..efde30f 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # markdown "sync" framework -An open-source publishing framework for AI agents and developers. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify. +An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify. Write markdown locally, run `npm run sync` (dev) or `npm run sync:prod` (production), and content appears instantly across all connected browsers. Built with React, Convex, and Vite. Optimized for AEO, GEO, and LLM discovery. diff --git a/content/blog/about-this-blog.md b/content/blog/about-this-blog.md index 1f3ae01..be819c9 100644 --- a/content/blog/about-this-blog.md +++ b/content/blog/about-this-blog.md @@ -15,7 +15,7 @@ authorImage: "/images/authors/markdown.png" # About This Markdown Framework -An open-source publishing framework for AI agents and developers. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify. +An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs.. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify. ## How It Works @@ -85,11 +85,13 @@ The setup takes about 10 minutes: **Sync commands:** **Development:** + - `npm run sync` - Sync markdown content - `npm run sync:discovery` - Update discovery files (AGENTS.md, llms.txt) - `npm run sync:all` - Sync content + discovery files together **Production:** + - `npm run sync:prod` - Sync markdown content - `npm run sync:discovery:prod` - Update discovery files - `npm run sync:all:prod` - Sync content + discovery files together diff --git a/content/blog/netlify-edge-excludedpath-ai-crawlers.md b/content/blog/netlify-edge-excludedpath-ai-crawlers.md index 2d4c7ff..bb79662 100644 --- a/content/blog/netlify-edge-excludedpath-ai-crawlers.md +++ b/content/blog/netlify-edge-excludedpath-ai-crawlers.md @@ -27,10 +27,6 @@ The goal: AI services fetch `/raw/{slug}.md` and parse clean markdown without HT I attempted to load and read the raw markdown at the URL you provided but was unable to fetch the content from that link. The page could not be loaded directly and I cannot access its raw markdown. ``` -``` -The page could not be loaded with the tools currently available, so its raw markdown content is not accessible. -``` - **Perplexity:** ``` diff --git a/content/pages/about.md b/content/pages/about.md index c1b7dd2..d26b0a9 100644 --- a/content/pages/about.md +++ b/content/pages/about.md @@ -3,10 +3,10 @@ title: "About" slug: "about" published: true order: 2 -excerpt: "An open-source publishing framework for AI agents and developers." +excerpt: "An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs.." --- -An open-source publishing framework for AI agents and developers. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify. +An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs.. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify. ## What makes it a dev sync system? @@ -17,11 +17,13 @@ An open-source publishing framework for AI agents and developers. Write markdown **Sync commands:** **Development:** + - `npm run sync` - Sync markdown content - `npm run sync:discovery` - Update discovery files (AGENTS.md, llms.txt) - `npm run sync:all` - Sync content + discovery files together **Production:** + - `npm run sync:prod` - Sync markdown content - `npm run sync:discovery:prod` - Update discovery files - `npm run sync:all:prod` - Sync content + discovery files together diff --git a/convex/http.ts b/convex/http.ts index a60c9de..ef9a22b 100644 --- a/convex/http.ts +++ b/convex/http.ts @@ -91,7 +91,7 @@ http.route({ site: SITE_NAME, url: SITE_URL, description: - "An open-source publishing framework for AI agents and developers. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify.", + "An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs.. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify.", posts: posts.map((post) => ({ title: post.title, slug: post.slug, @@ -214,7 +214,7 @@ http.route({ site: SITE_NAME, url: SITE_URL, description: - "An open-source publishing framework for AI agents and developers. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify.", + "An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs.. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify.", exportedAt: new Date().toISOString(), totalPosts: fullPosts.length, posts: fullPosts, diff --git a/convex/rss.ts b/convex/rss.ts index 9264a00..ea37904 100644 --- a/convex/rss.ts +++ b/convex/rss.ts @@ -5,7 +5,7 @@ import { api } from "./_generated/api"; const SITE_URL = process.env.SITE_URL || "https://www.markdown.fast"; const SITE_TITLE = "markdown sync framework"; const SITE_DESCRIPTION = - "An open-source publishing framework for AI agents and developers. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify."; + "An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs.. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify."; // Escape XML special characters function escapeXml(text: string): string { diff --git a/index.html b/index.html index db67985..d460183 100644 --- a/index.html +++ b/index.html @@ -12,7 +12,7 @@ @@ -48,7 +48,7 @@ Your content is instantly available to browsers, LLMs, and AI agents. diff --git a/public/raw/about-this-blog.md b/public/raw/about-this-blog.md index 35fd43b..dfab9e6 100644 --- a/public/raw/about-this-blog.md +++ b/public/raw/about-this-blog.md @@ -11,7 +11,7 @@ Tags: convex, netlify, open-source, markdown, ai, llm # About This Markdown Framework -An open-source publishing framework for AI agents and developers. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify. +An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs.. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify. ## How It Works @@ -81,11 +81,13 @@ The setup takes about 10 minutes: **Sync commands:** **Development:** + - `npm run sync` - Sync markdown content - `npm run sync:discovery` - Update discovery files (AGENTS.md, llms.txt) - `npm run sync:all` - Sync content + discovery files together **Production:** + - `npm run sync:prod` - Sync markdown content - `npm run sync:discovery:prod` - Update discovery files - `npm run sync:all:prod` - Sync content + discovery files together diff --git a/public/raw/about.md b/public/raw/about.md index 4ff99d8..afb7221 100644 --- a/public/raw/about.md +++ b/public/raw/about.md @@ -5,7 +5,7 @@ Type: page Date: 2025-12-25 --- -An open-source publishing framework for AI agents and developers. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify. +An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs.. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify. ## What makes it a dev sync system? @@ -16,11 +16,13 @@ An open-source publishing framework for AI agents and developers. Write markdown **Sync commands:** **Development:** + - `npm run sync` - Sync markdown content - `npm run sync:discovery` - Update discovery files (AGENTS.md, llms.txt) - `npm run sync:all` - Sync content + discovery files together **Production:** + - `npm run sync:prod` - Sync markdown content - `npm run sync:discovery:prod` - Update discovery files - `npm run sync:all:prod` - Sync content + discovery files together diff --git a/public/raw/index.md b/public/raw/index.md index 7bb3ee8..d5bb963 100644 --- a/public/raw/index.md +++ b/public/raw/index.md @@ -32,7 +32,7 @@ This is the homepage index of all published content. ## Pages (5) - **[Docs](/raw/docs.md)** -- **[About](/raw/about.md)** - An open-source publishing framework for AI agents and developers. +- **[About](/raw/about.md)** - An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs.. - **[Projects](/raw/projects.md)** - **[Contact](/raw/contact.md)** - **[Changelog](/raw/changelog.md)** diff --git a/public/raw/netlify-edge-excludedpath-ai-crawlers.md b/public/raw/netlify-edge-excludedpath-ai-crawlers.md index 27e3927..dfcb697 100644 --- a/public/raw/netlify-edge-excludedpath-ai-crawlers.md +++ b/public/raw/netlify-edge-excludedpath-ai-crawlers.md @@ -27,10 +27,6 @@ The goal: AI services fetch `/raw/{slug}.md` and parse clean markdown without HT I attempted to load and read the raw markdown at the URL you provided but was unable to fetch the content from that link. The page could not be loaded directly and I cannot access its raw markdown. ``` -``` -The page could not be loaded with the tools currently available, so its raw markdown content is not accessible. -``` - **Perplexity:** ``` diff --git a/scripts/sync-discovery-files.ts b/scripts/sync-discovery-files.ts index b43d48e..6fb139f 100644 --- a/scripts/sync-discovery-files.ts +++ b/scripts/sync-discovery-files.ts @@ -97,10 +97,10 @@ function loadSiteConfig(): SiteConfigData { title: titleMatch?.[1] || "markdown sync framework", bio: bioMatch?.[1] || - "An open-source publishing framework for AI agents and developers.", + "An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs..", description: bioMatch?.[1] || - "An open-source publishing framework for AI agents and developers.", + "An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs..", gitHubRepo, }; } @@ -111,18 +111,16 @@ function loadSiteConfig(): SiteConfigData { return { name: "markdown sync framework", title: "markdown sync framework", - bio: "An open-source publishing framework for AI agents and developers.", + bio: "An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs..", description: - "An open-source publishing framework for AI agents and developers.", + "An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs..", }; } // Get site URL from environment or config function getSiteUrl(): string { return ( - process.env.SITE_URL || - process.env.VITE_SITE_URL || - "https://markdown.fast" + process.env.SITE_URL || process.env.VITE_SITE_URL || "https://markdown.fast" ); } @@ -383,4 +381,3 @@ syncDiscoveryFiles().catch((error) => { console.error("Error syncing discovery files:", error); process.exit(1); }); - diff --git a/src/pages/Home.tsx b/src/pages/Home.tsx index 39a41fe..985a25d 100644 --- a/src/pages/Home.tsx +++ b/src/pages/Home.tsx @@ -95,12 +95,10 @@ export default function Home() { {/* Intro with JSX support for links */}

- - An open-source publishing framework for AI agents and developers. - {" "} -
- Write markdown, sync from the terminal.
-
+ An open-source publishing framework built for AI agents and developers +

+ to ship websites, docs, or blogs.

+
Write markdown, sync from the terminal.{" "}