Update OpenAPI documentation

Author: mgks

docmd-main/v07/de/navigation.json

@@ -234,6 +234,10 @@
         "title": "LLMs",
         "path": "/plugins/llms"
       },
+      {
+        "title": "OpenAPI",
+        "path": "/plugins/openapi"
+      },
       {
         "title": "Mermaid",
         "path": "/plugins/mermaid"

docmd-main/v07/de/plugins/openapi.md

@@ -5,8 +5,8 @@ description: "Rendert OpenAPI 3.x API-Referenzdokumentation direkt aus JSON- ode
 
 Das **OpenAPI-Plugin** wandelt OpenAPI 3.x Spezifikationsdateien in strukturierte API-Referenzseiten um — zur Build-Zeit gerendert, ohne clientseitiges JavaScript und ohne Drittanbieter-Abhängigkeiten. Jeder Endpunkt, Parameter, Request-Body und jede Response wird in semantische HTML-Tabellen konvertiert.
 
-::: callout info "Optionales Plugin"
-Das OpenAPI-Plugin ist **nicht** in `@docmd/core` enthalten. Installieren Sie es separat, wenn Sie API-Dokumentation neben Ihrem Markdown-Inhalt einbetten müssen. Kein Swagger UI oder Redoc — das Plugin liest Ihre Spezifikation und gibt sauberes, zugängliches HTML zur Build-Zeit aus.
+::: callout info "Kern-Plugin"
+Das OpenAPI-Plugin ist jetzt standardmäßig in `@docmd/core` **enthalten**. Eine separate Installation ist nicht erforderlich. Es folgt der Docmd-Philosophie des Build-Zeit-Renderings — das Plugin liest Ihre Spezifikation und gibt saubere, zugängliche HTML-Tabellen ohne clientseitiges JavaScript aus.
 :::
 
 ## Installation
@@ -32,11 +32,19 @@ export default defineConfig({
 Betten Sie eine OpenAPI-Spezifikation in jede Markdown-Seite ein, indem Sie einen umzäunten Codeblock mit dem `openapi`-Sprach-Tag verwenden:
 
 ````markdown
+### Live-Beispiel
+
 ```openapi
-./api/openapi.json
+assets/docmd-api.json
 ```
 ````
 
+### Ergebnis
+
+```openapi
+assets/docmd-api.json
+```
+
 Der Pfad wird relativ zu Ihrem `src`-Verzeichnis aufgelöst. Sowohl **JSON** als auch **YAML**-Formate werden unterstützt. YAML erfordert die Installation von `js-yaml`:
 
 ```bash

docmd-main/v07/en/navigation.json

@@ -238,6 +238,10 @@
         "title": "LLMs",
         "path": "/plugins/llms"
       },
+      {
+        "title": "OpenAPI",
+        "path": "/plugins/openapi"
+      },
       {
         "title": "Mermaid",
         "path": "/plugins/mermaid"

docmd-main/v07/en/plugins/openapi.md

@@ -5,8 +5,8 @@ description: "Render OpenAPI 3.x API reference documentation directly from JSON
 
 The **OpenAPI plugin** turns OpenAPI 3.x specification files into structured API reference pages - rendered at build time with no client-side JavaScript and no third-party dependencies. Every endpoint, parameter, request body, and response is converted to semantic HTML tables.
 
-::: callout info "Optional Plugin"
-The OpenAPI plugin is **not** bundled with `@docmd/core`. Install it separately when you need to embed API documentation alongside your Markdown content. No Swagger UI or Redoc is involved - the plugin reads your spec and outputs clean, accessible HTML at build time.
+::: callout info "Core Plugin"
+The OpenAPI plugin is **included** by default in `@docmd/core`. There is no need to install it separately. It follows the Docmd philosophy of build-time rendering - the plugin reads your spec and outputs clean, accessible HTML tables with zero client-side JavaScript.
 :::
 
 ## Installation
@@ -32,11 +32,19 @@ export default defineConfig({
 Embed an OpenAPI spec in any Markdown page using a fenced code block with the `openapi` language tag:
 
 ````markdown
+### Live Example
+
 ```openapi
-./api/openapi.json
+assets/docmd-api.json
 ```
 ````
 
+### Result
+
+```openapi
+assets/docmd-api.json
+```
+
 The path is resolved relative to your `src` directory. Both **JSON** and **YAML** formats are supported. YAML requires `js-yaml` to be installed:
 
 ```bash

docmd-main/v07/zh/navigation.json

@@ -234,6 +234,10 @@
         "title": "LLMs",
         "path": "/plugins/llms"
       },
+      {
+        "title": "OpenAPI",
+        "path": "/plugins/openapi"
+      },
       {
         "title": "Mermaid 图表",
         "path": "/plugins/mermaid"

docmd-main/v07/zh/plugins/openapi.md

@@ -5,8 +5,8 @@ description: "直接在 Markdown 页面中从 JSON 或 YAML 规范文件渲染 O
 
 **OpenAPI 插件**将 OpenAPI 3.x 规范文件转换为结构化的 API 参考页面——在构建时渲染，无需客户端 JavaScript，无需第三方依赖。每个端点、参数、请求体和响应都转换为语义化 HTML 表格。
 
-::: callout info "可选插件"
-OpenAPI 插件**未**与 `@docmd/core` 捆绑。当您需要在 Markdown 内容旁边嵌入 API 文档时，请单独安装。不涉及 Swagger UI 或 Redoc——插件在构建时读取规范并输出干净的静态 HTML。
+::: callout info "核心插件"
+OpenAPI 插件现在已**内置**于 `@docmd/core` 中，无需单独安装。它遵循 Docmd 的构建时渲染理念——插件在构建时读取您的规范并输出干净、可访问的 HTML 表格，无需客户端 JavaScript。
 :::
 
 ## 安装
@@ -32,11 +32,19 @@ export default defineConfig({
 在任何 Markdown 页面中使用带 `openapi` 语言标签的围栏代码块嵌入 OpenAPI 规范：
 
 ````markdown
+### 实时示例
+
 ```openapi
-./api/openapi.json
+assets/docmd-api.json
 ```
 ````
 
+### 渲染结果
+
+```openapi
+assets/docmd-api.json
+```
+
 路径相对于您的 `src` 目录解析。支持 **JSON** 和 **YAML** 格式。YAML 需要安装 `js-yaml`：
 
 ```bash