mdorigin

mdorigin 是一个面向人类与智能体（agents）的 markdown 优先发布引擎。

它让 markdown 保持直接可寻址，从同一批文件渲染无扩展名的 HTML，并可以把同一棵内容树发布到本地预览或 Cloudflare Workers。

如果想快速上手，从快速开始开始，然后阅读配置、扩展与Cloudflare 部署。

核心原则

mdorigin 不是模板系统。它的内核是路由模型，以及从 markdown 树构建的规范化内容模型。

这意味着：

• mdorigin 拥有路由与内容语义
• 默认渲染内置提供
• 高级用户可以用代码整体替换页面渲染
• 扩展不应该需要替换请求管道本身

换句话说，mdorigin 是一个可编程的发布内核。扩展系统让用户可以在同一路由与内容内核之上构建自己的页面布局，包括目录式页面。

它能做什么

• 文件系统路由直接映射为发布路由
• .md 始终可以作为原始源码访问
• .html 与无扩展名路由从同一份 markdown 为人类渲染
• 相对路径的资源保持在内容旁边
• 同一内核同时服务本地 Node 预览与 Cloudflare Workers
• 可选的搜索与 /api/search 由 indexbind 提供支持
• indexbind 文档：https://indexbind.jolestar.workers.dev

项目说明

为什么会有 mdorigin 用一页解释项目方向，并给出 markdown 优先模型最简短的论证。

顶部导航与各章节索引覆盖其余文档。