MarkWay 是一个 Markdown 优先的协议，它将 Web 体验转化为 AI 最能理解的结构化、语义化内容。 Web → Markdown → Agent
# User List
| ID | Name | Email |
|----|------|-------|
| 1 | Alice| a@ex.com |
| 2 | Bob | b@ex.com |
[View Details](users/1.md)Web 为人类设计，而非机器。AI Agent 在传统 Web 浏览中面临重重挑战。
需要解析复杂的 HTML 结构，处理不一致的类名和 DOM 结构
必须执行 JavaScript 才能渲染内容，计算开销巨大
面临反爬虫措施和速率限制，访问不稳定
需要从视觉布局中提取有意义的数据，容错性差
MarkWay 将内容直接以 Markdown 格式提供，带来全新的 AI 浏览体验。
内容结构明确无歧义，标题、列表、表格一目了然
无需 HTML 解析开销或 DOM 操作，直接读取结构化数据
AI 像阅读文档一样读取内容，符合训练数据特性
内置机制让 Agent 自动理解网站结构，无需人工配置
MarkWay 支持静态和动态两种内容提供模式，满足不同场景需求。
内容以 Markdown 文件形式组织，目录结构清晰可预测
docs/
├── index.md
├── getting-started.md
├── api/
│ ├── index.md
│ └── reference.md交互式端点使用 HTTP 方法语义化地提供内容
GET /api/users.md
→ 返回用户列表文档
POST /api/search.md
→ 返回搜索结果在每个目录创建 index.md，包含文件列表及用途说明
根目录请求必须链接到协议文档 /protocol
以 Markdown 格式提供内容，Agent 即可自动发现和使用
人类可读的文档，Agent 可以完美解析
人类和 AI 都能访问的结构化信息
查询端点具有自描述的接口
专为 Agent 消费设计的 Web 服务