零构建 Markdown 服务器,供人类和 AI 代理使用
mkdnsite,来自Mkdnsite,是一个原生Markdown的网络服务器,能够为人类读者和AI代理提供文档,而无需静态网站构建步骤。它在运行时将Markdown渲染为HTML,并通过HTTP内容协商公开原始Markdown,同时为代理集成提供模型上下文协议端点。该应用程序支持GitHub风格的Markdown、KaTeX和Mermaid渲染,以及全文搜索,旨在满足需要源同步文档的开发人员、技术写作人员和以AI为中心的团队。
你实际上可以用它做什么任务?
该应用程序针对结合人类浏览和机器消费的文档工作流程,包括 AI 辅助本地化和代理索引。它提供与 MCP 主机(如 Claude Desktop、Cursor 和 Zed)兼容的原生模型上下文协议端点,并且可以使用命令行标志指向公共或私有的 GitHub 存储库,使其对在 Git 中托管源并期望即时站点可用性的团队实用。
内容代理接收的内容有多忠实?
当请求包含 Accept: text/markdown 头时,服务器返回原始 Markdown 源,保留 GitHub 风格的 Markdown 结构,如表格和任务列表。该交付保留了源结构以便于下游处理。该应用程序还支持 KaTeX、Mermaid、语法高亮和 Chart.js 用于渲染的 HTML,这使得视觉输出与面向代理的 Markdown 流分开。
该应用程序在开发者环境中运行是否简单?
开发者提供跨环境兼容性:服务器在 Bun、Node.js 或 Deno 上运行,并作为独立可执行文件或 Docker 容器提供。渲染在运行时使用 React 服务器端渲染,界面包括带有 ⌘K 模态的 TF-IDF 全文搜索以及由文件结构驱动的自动生成侧边栏和目录,这适合现有的基于存储库的文档管道。
优选方案,适合优先考虑实时、源文件优先的文档团队
该应用程序是开发人员和技术写作团队的实用选择,他们需要与源文件保持一致并且可以立即被代理使用的文档。如果您的工作流程假设预构建的工件,预计将需要服务器部署和适度的集成工作。接受运行时服务器以换取直接Markdown访问的团队将发现该应用程序与面向代理的文档管道一致。