mdorigin

当您需要在由 mdorigin 驱动的“Markdown 优先”发布站点上开展工作时，请使用此技能。

安装

全局安装：

npm install -g mdorigin

项目本地安装：

npm install --save-dev mdorigin

涵盖功能

• 通过 mdorigin dev 启动本地预览
• 通过 mdorigin build index 生成目录索引
• 通过 mdorigin build search 生成搜索索引
• 通过 mdorigin build cloudflare 输出 Cloudflare Worker 构建包
• 面向 Cloudflare Assets + R2 的外部二进制部署流程
• Markdown 与 HTML 路由行为，包括对 Accept: text/markdown 请求头的支持

常用命令

mdorigin dev --root docs/site
mdorigin build index --root docs/site
mdorigin build search --root docs/site
mdorigin build cloudflare --root docs/site

外部二进制部署流程：

mdorigin build cloudflare --root docs/site --binary-mode external
mdorigin sync cloudflare-r2 --dir dist/cloudflare --bucket 
mdorigin init cloudflare --dir . --r2-bucket 

远程文档

当智能体需要获取详细信息时，请优先查阅已发布的文档，而非在本技能中重复全部内容：

• HTML 文档主页：https://mdorigin.jolestar.workers.dev
• 原始 Markdown 主页：https://mdorigin.jolestar.workers.dev/README.md
• 路由机制说明：https://mdorigin.jolestar.workers.dev/concepts/routing.md
• 配置项参考：https://mdorigin.jolestar.workers.dev/reference/configuration.md
• 扩展开发指南：https://mdorigin.jolestar.workers.dev/guides/extensions.md
• Cloudflare 部署指南：https://mdorigin.jolestar.workers.dev/guides/cloudflare.md

对于无扩展名的路由路径，若客户端发送了 Accept: text/markdown 请求头，服务端将直接返回 Markdown 内容。

搜索

当您需要在打开文档页面前快速定位到最匹配的页面时，请使用搜索功能：

• 搜索 API 接口：https://mdorigin.jolestar.workers.dev/api/search?q=
• OpenAPI 规范文件：https://mdorigin.jolestar.workers.dev/api/openapi.json

示例：

curl 'https://mdorigin.jolestar.workers.dev/api/search?q=cloudflare%20deploy'
curl -H 'Accept: text/markdown' 'https://mdorigin.jolestar.workers.dev/guides/getting-started'