Zero-build Markdown server for humans and AI agents
mkdnsite, from Mkdnsite, is a Markdown-native web server that serves documentation to both human readers and AI agents without a static-site build step. It renders Markdown to HTML at runtime and exposes raw Markdown via HTTP content negotiation while offering a Model Context Protocol endpoint for agent integrations. The app supports GitHub-Flavored Markdown, KaTeX and Mermaid rendering, and full-text search, aimed at developers, technical writers, and AI-focused teams who need source-synchronized documentation.
What tasks can you actually use it for?
The app targets documentation workflows that combine human browsing and machine consumption, including AI-assisted localization and agent indexing. It provides a native Model Context Protocol endpoint compatible with MCP hosts such as Claude Desktop, Cursor, and Zed, and it can point at public or private GitHub repositories using a command-line flag, making it practical for teams that host sources in Git and expect immediate site availability.
How faithful is the content agents receive?
When a request includes an Accept: text/markdown header, the server returns the original Markdown source, preserving GitHub-Flavored Markdown constructs such as tables and task lists. That delivery preserves source structure for downstream processing. The app also supports KaTeX, Mermaid, syntax highlighting, and Chart.js for rendered HTML, which keeps visual output separate from the agent-facing Markdown stream.
Is the app straightforward to run in developer environments?
The developer supplies cross-environment compatibility: the server runs on Bun, Node.js, or Deno, and is available as a standalone executable or Docker container. Rendering uses React server-side rendering at runtime, and the interface includes a TF-IDF full-text search with a ⌘K modal plus auto-generated sidebars and tables of contents driven by file structure, which fits existing repo-based documentation pipelines.
Practical choice for teams prioritizing live, source-first documentation
The app is a practical option for developer and technical-writing teams who need documentation that stays identical to source files and is immediately consumable by agents. Expect a server-based deployment and modest integration work if your workflow assumes prebuilt artifacts. Teams that accept a runtime server in exchange for direct Markdown access will find the app aligns with agent-oriented documentation pipelines.
