Zero-build Markdown-server voor mensen en AI-agenten
mkdnsite, van Mkdnsite, is een Markdown-native webserver die documentatie levert aan zowel menselijke lezers als AI-agenten zonder een statische site build stap. Het rendert Markdown naar HTML tijdens runtime en exposeert ruwe Markdown via HTTP contentonderhandeling terwijl het een Model Context Protocol endpoint biedt voor agentintegraties. De app ondersteunt GitHub-Flavored Markdown, KaTeX en Mermaid rendering, en full-text search, gericht op ontwikkelaars, technische schrijvers en AI-georiënteerde teams die bron-synchronisatie documentatie nodig hebben.
Voor welke taken kun je het eigenlijk gebruiken?
De app richt zich op documentatieworkflows die menselijke browsen en machineconsumptie combineren, inclusief AI-ondersteunde lokalisatie en agentindexering. Het biedt een native Model Context Protocol-eindpunt dat compatibel is met MCP-hosts zoals Claude Desktop, Cursor en Zed, en het kan wijzen naar openbare of privé GitHub-repositories met behulp van een commandoregelvlag, waardoor het praktisch is voor teams die bronnen in Git hosten en onmiddellijke sitebeschikbaarheid verwachten.
Hoe trouw is de inhoud die agents ontvangen?
Wanneer een verzoek een Accept: text/markdown header bevat, retourneert de server de originele Markdown-bron, waarbij GitHub-Flavored Markdown-constructies zoals tabellen en takenlijsten behouden blijven. Die levering behoudt de bronstructuur voor downstreamverwerking. De app ondersteunt ook KaTeX, Mermaid, syntaxisaccentuering en Chart.js voor gerenderde HTML, wat de visuele output gescheiden houdt van de agent-facing Markdown-stroom.
Is de app eenvoudig te draaien in ontwikkelomgevingen?
De ontwikkelaar biedt cross-omgeving compatibiliteit: de server draait op Bun, Node.js of Deno, en is beschikbaar als een zelfstandige uitvoerbare of Docker-container. Rendering gebruikt React server-side rendering tijdens runtime, en de interface omvat een TF-IDF full-text search met een ⌘K-modal plus automatisch gegenereerde zijbalken en inhoudsopgaven aangedreven door de bestandsstructuur, wat past in bestaande repo-gebaseerde documentatiepipelines.
Praktische keuze voor teams die prioriteit geven aan live, bron-eerst documentatie
De app is een praktische optie voor ontwikkelaars- en technische schrijfteams die documentatie nodig hebben die identiek blijft aan bronbestanden en onmiddellijk door agenten kan worden gebruikt. Verwacht een servergebaseerde implementatie en bescheiden integratiewerkzaamheden als je workflow uitgaat van vooraf gebouwde artefacten. Teams die een runtime-server accepteren in ruil voor directe Markdown-toegang, zullen ontdekken dat de app aansluit bij agentgerichte documentatiepijplijnen.
