x/wiki
1
0
Fork 0
mirror of https://github.com/waynesutton/markdown-site.git synced 2026-01-12 04:09:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

update: homepage and descrption text

Browse Source
This commit is contained in:
Wayne Sutton
2025-12-25 00:47:40 -08:00
parent 01db0a70e2
commit 66c7f161bd
15 changed files with 33 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
AGENTS.md
View File

@@ -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

2
README.md
View File

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

4
content/blog/about-this-blog.md
View File

@@ -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

4
content/blog/netlify-edge-excludedpath-ai-crawlers.md
View File

@@ -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:**
```

6
content/pages/about.md
View File

@@ -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

4
convex/http.ts
View File

@@ -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,

2
convex/rss.ts
View File

@@ -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 {

8
index.html
View File

@@ -12,7 +12,7 @@
<!-- SEO Meta Tags -->
<meta
name="description"
content="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."
content="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."
/>
<meta name="author" content="markdown sync publishing framework" />
<meta
@@ -28,7 +28,7 @@
<meta property="og:title" content="markdown sync publishing framework" />
<meta
property="og:description"
content="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."
content="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."
/>
<meta property="og:type" content="website" />
<meta property="og:url" content="https://www.markdown.fast/" />
@@ -48,7 +48,7 @@
<meta name="twitter:title" content="markdown sync publishing framework" />
<meta
name="twitter:description"
content="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."
content="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."
/>
<meta
name="twitter:image"
@@ -79,7 +79,7 @@
"@type": "WebSite",
"name": "markdown sync framework",
"url": "https://www.markdown.fast",
"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.",
"description": "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.",
"author": {
"@type": "Organization",
"name": "markdown sync framework",

2
public/llms.txt
View File

@@ -1,6 +1,6 @@
# llms.txt - Information for AI assistants and LLMs
# Learn more: https://llmstxt.org/
# Last updated: 2025-12-25T08:31:10.582Z
# Last updated: 2025-12-25T08:46:57.373Z
> Your content is instantly available to browsers, LLMs, and AI agents.

4
public/raw/about-this-blog.md
View File

@@ -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

4
public/raw/about.md
View File

@@ -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

2
public/raw/index.md
View File

@@ -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)**

4
public/raw/netlify-edge-excludedpath-ai-crawlers.md
View File

@@ -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:**
```

13
scripts/sync-discovery-files.ts
View File

@@ -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);
});

10
src/pages/Home.tsx
View File

@@ -95,12 +95,10 @@ export default function Home() {
{/* Intro with JSX support for links */}
<p className="home-intro">
<strong>
An open-source publishing framework for AI agents and developers.
</strong>{" "}
<br />
Write markdown, sync from the terminal. <br />
<br />
An open-source publishing framework built for AI agents and developers
<br></br>
to ship websites, docs, or blogs. <br></br>
<br /> Write markdown, sync from the terminal.{" "}
<a
href="https://github.com/waynesutton/markdown-site"
target="_blank"