cnkang/nginx-markdown-for-agents

Was macht nginx-markdown-for-agents?

Selbst gehostetes NGINX-Modul, das Markdown an KI-Agenten über HTTP-Content-Negotiation ausliefert (Accept: text/markdown), unterstützt von einem Rust-Konverter.

Funktionsweise

Dieses Modul fängt eingehende Anfragen an NGINX ab und prüft den Accept-Header. Wenn der Client text/markdown anfordert (wie es KI-Agenten typischerweise tun), wird die angeforderte HTML-Seite serverseitig in Markdown konvertiert und zurückgegeben. Für normale Browser bleibt das Verhalten unverändert.

Anwendungsfälle

• KI-Entwicklungstools: Agenten wie Claude Code, Cursor oder Codex können Dokumentation und Webinhalte direkt in Markdown erhalten.
• Content-Repurposing: Automatische Bereitstellung von Inhalten in zwei Formaten (HTML und Markdown) ohne separate Seiten.
• API-Ersatz: Statt einer dedizierten API kann jeder beliebige HTML-Endpunkt auch als Markdown-Quelle dienen.

Konfiguration

server {
    listen 80;
    server_name example.com;

    # Markdown-Konvertierung aktivieren
    markdown on;

    location / {
        root /var/www/html;
        index index.html;
    }
}

Installation

1. Kompilieren Sie das Modul mit Ihrem NGINX-Source-Code (siehe BUILD.md).
2. Fügen Sie die obige Konfiguration in Ihre nginx.conf ein.
3. Starten Sie NGINX neu.

Integration mit KI-Agenten

Ein Agent kann eine Seite wie folgt anfordern:

curl -H "Accept: text/markdown" http://example.com/docs

Die Antwort enthält den Markdown-Inhalt der Seite.

Technische Details

• Sprache: Rust (für Geschwindigkeit und Speichersicherheit)
• Konverter: Nutzt html2md (Rust-Bibliothek)
• Protokoll: HTTP/1.1, Content-Negotiation

Lizenz

MIT