AI时代建网站写个MD文档就够了

直接看效果

渲染出来就是这样➡️：

AMNW：一份 Markdown，同时喂给 AI Agent 和浏览器

最近开源了一个项目，解决的问题很具体：维护「给 Agent 读的接口」和「给人看的页面」是两套工作。

通常的做法是：

• • 给 Agent 单独做 API 或结构化文档
• • 给用户做 HTML 页面 / 前端组件
• • 内容更新时两边都要改

AMNW（Agent Markdown-Native-Web）换了一个思路：Markdown 作为唯一数据源，同一个 .md 文件，Agent 直接读原文，浏览器加载渲染器后变成带 DaisyUI 界面的页面。

怎么做到的

核心是扩展了 Markdown 的语法：

---title: 帐篷商品列表agent-role: product-listactions:  - id: add-to-cart    method: POST    endpoint: /api/cart/add---:::card-grid:::card![超轻单人帐](img.jpg)## 超轻单人帐 UL**¥499**[加入购物车](#){rel=action action-id=add-to-cart item-id=SKU-001}::::::

• • Frontmatter 声明页面角色和可执行的 actions，Agent 直接解析
• • :::card-grid / :::card 等容器块，浏览器渲染为 DaisyUI 组件，Agent 读到的是干净的 Markdown 语义
• • rel=action 链接，浏览器变成按钮，Agent 知道这是一个可执行操作

接入方式

每个 .md 文件头部嵌入一行引导脚本：

<!--BROWSER-ONLY: Agent please skip this block--><script src="/amnx-bootstrap.js"></script><!--END BROWSER-ONLY-->

浏览器触发加载 DaisyUI + Tailwind + 渲染器（gzip ~76 KB），Agent 访问时忽略这段，直接读 Markdown 原文。

全站样式、导航栏、生命周期钩子（购物车、Toast、Action 响应）统一在 site.config.js 配置，不污染 .md 文件。

本地体验

git clone https://github.com/wuguirongsg/AMNWnpm ci && npm run build && node server.js

访问 http://localhost:3005/，examples/ 下有商品列表、商品详情、产品对比、博客文章等几个示例页面。

当前状态

• • @amnw/parser：自研栈式容器解析器（替代了有嵌套 bug 的 remark-directive），支持任意深度嵌套容器
• • @amnw/renderer：AST → DaisyUI HTML，4 种布局模式（顶栏 / 左侧栏 / 右侧栏 / 纯侧边栏），支持自定义 CSS/JS 钩子
• • 文档覆盖快速开始、语法规范、Agent 集成协议

后续计划包括 CLI 工具、生产构建管道（PurgeCSS）、Shiki 代码高亮、MCP Server 适配器等，详见 ROADMAP.md。

MIT 开源，欢迎 issue 和 PR。

👉 https://github.com/wuguirongsg/AMNW

👉 https://gitee.com/wuguirong/AMNW