OpenAPI 插件 : docmd docs

@docmd/plugin-openapi 插件将 OpenAPI 3.x 规范文件（JSON 或 YAML）转换为结构化的、可搜索的 API 参考页面。遵循 docmd 的“零 JS”运行时理念，每个端点、参数表格和 Schema 模型都会在构建处理期间被编译为静态 HTML。

配置选项

在 docmd.config.json 中配置全局 OpenAPI 渲染参数：

选项	类型	默认值	技术描述
`info`	`boolean`	`true`	显示规范 `info` 块中的 API 标题、版本与描述。
`download`	`boolean`	`false`	添加原始 JSON/YAML 规范文件的直接下载链接。
`summaryOnly`	`boolean`	`false`	仅渲染高层 HTTP 方法与路径摘要，不展示完整的参数 Schema。
`allowRawHtml`	`boolean`	`false`	允许在规范描述字符串中使用未转义的原始 HTML。

docmd.config.json

{
  "plugins": {
    "openapi": {
      "info": true,
      "download": true,
      "summaryOnly": false
    }
  }
}

使用带有 openapi 语言标记的围栏代码块嵌入 OpenAPI 规范。请指定源于您文档源码根目录的相对文件路径：

```openapi
assets/openapi.json
```

插件会解析并渲染：

零-JS 构建期执行

所有 OpenAPI 规范均在编译期间解析为静态 HTML。运行时无需加载任何沉重的客户端 JavaScript 库，确保极简的页面加载时间与完全的搜索索引能力。