Markdown‑Site: Open‑Source‑Publishing‑Framework für Echtzeit‑Markdown‑Sync
Key Takeaway
Summary
- GitHub‑Repository von
waynesutton/markdown-site mit Open‑Source‑Lizenz (MIT).
- Fokus: Markdown‑Schreiben, sofortige Echtzeit‑Sync via Convex, Hosting über Netlify.
- Workflow: Markdown‑Dateien in
content/blog/ bzw. content/pages/ erstellen → npm run sync (dev) oder npm run sync:prod (prod) → Inhalte werden in Convex hochgeladen und sofort im Live‑Site angezeigt.
- Versionierung: Inhalte sind Code‑Dateien im Git‑Repo, erlaubt Commit‑History, Diff‑Review, Rollback.
- Setup: Node ≥18, Convex‑Account.
npm install, npx convex dev (erstellt .env.local), npm run dev → http://localhost:5173. Für Produktions‑Sync: .env.production.local mit VITE_CONVEX_URL=<> setzen, dann npm run sync:prod.
- Fork‑Konfiguration: Automatischer Modus (
npm run configure) aktualisiert alle 11 Konfigurationsdateien. Manueller Modus über FORK_CONFIG.md.
- Features: Markdown‑Blog mit Frontmatter, Syntax‑Highlighting, vier Theme‑Optionen (Dark, Light, Tan, Cloud). Echtzeit‑Daten (Convex), responsive Design, Echtzeit‑Analytics unter
/stats.
- SEO & Discovery: RSS Feeds (
/rss.xml, /rss-full.xml), dynamisches Sitemap, JSON‑LD, Open‑Graph/Twitter‑Meta, robots.txt. llms.txt für KI‑Crawling, .well-known/ai-plugin.json, openapi.yaml.
- AI‑Zugriff:
/api/posts, /api/post?slug=…, /api/export, /raw/{slug}.md, Copy‑Page‑Dropdown für ChatGPT/Claude/Perplexity.
- Content Import: Externe URLs als Markdown‑Posts via Firecrawl (
npm run import <url>).
- Weitere UI‑Features: Logo‑Gallery (konfigurierbar), GitHub‑Contributions‑Graph, Visitor‑Map (Netlify Geo‑Detection, keine IP‑Speicherung).
- Deploy: Netlify‑Projekt (
markdowncms), Edge‑Functions nutzen VITE_CONVEX_URL. --include=dev nötig wegen NODE_ENV=production; siehe netlify-deploy-fix.md.
- Theme‑Konfiguration: Standard‑Theme: Tan; weitere Optionen über
siteConfig.ts.
Related Queries
- Welche Voraussetzungen muss ich für die Produktion der markdown‑site erfüllen?
- Wie gehe ich vor, um einen externen Blogpost mit Firecrawl zu importieren?
- Wo finde ich die Konfiguration für die Visitor‑Map auf der Statistikseite?
Quelle: https://github.com/waynesutton/markdown-site
