Document x-mint content and custom MDX for AsyncAPI pages

api-playground/asyncapi-setup.mdx

@@ -95,10 +95,49 @@
 ```
 
 <Note>
   The `directory` field is optional. If not specified, Mintlify adds the files to the **api-reference** folder of the docs repository.
 </Note>
 
-## Channel page
+## Customize channel pages
+
+### Custom MDX content
+
+Add custom MDX content below the frontmatter in your `asyncapi:` page to render it above the auto-generated channel documentation. This works the same way as [custom content for OpenAPI pages](/api-playground/openapi-setup#content).
+
+```mdx
+---
+title: "Websocket Channel"
+asyncapi: "/path/to/asyncapi.json channelName"
+---
+
+## Prerequisites
+
+You must authenticate before connecting to this channel.
+
+<Note>This channel requires a valid API key passed as a query parameter.</Note>
+```
+
+### x-mint extension
+
+You can add content to auto-generated channel pages directly in your AsyncAPI spec using the `x-mint` extension. Add `x-mint: content` to a channel to include MDX content above the channel documentation without creating a separate MDX file.
+
+```yaml {6-8}
+channels:
+  userEvents:
+    address: /events/users
+    description: Real-time user events
+    x-mint:
+      content: |
+        ## Overview
+        Subscribe to this channel to receive real-time user activity events.
+    messages:
+      userEvent:
+        $ref: '#/components/messages/UserEvent'
+```
+
+The `x-mint: content` extension supports all Mintlify MDX components and formatting.
+
+### Channel page
 
 If you want more control over how you order your channels or if you want to reference only specific channels, create an MDX file with the `asyncapi` property in the frontmatter.
 

es/api-playground/asyncapi-setup.mdx

@@ -110,9 +110,46 @@ Para generar automáticamente páginas para todos los canales de tu esquema Asyn
 </Note>
 
 
-<div id="channel-page">
-  ## Página de canal
-</div>
+## Personalizar páginas de canales
+
+### Contenido MDX personalizado
+
+Agrega contenido MDX personalizado debajo del frontmatter en tu página `asyncapi:` para mostrarlo encima de la documentación de canal generada automáticamente. Esto funciona de la misma manera que el [contenido personalizado para páginas OpenAPI](/es/api-playground/openapi-setup#content).
+
+```mdx
+---
+title: "Canal WebSocket"
+asyncapi: "/path/to/asyncapi.json channelName"
+---
+
+## Requisitos previos
+
+Debes autenticarte antes de conectarte a este canal.
+
+<Note>Este canal requiere una clave de API válida pasada como parámetro de consulta.</Note>
+```
+
+### Extensión x-mint
+
+Puedes agregar contenido a las páginas de canal generadas automáticamente directamente en tu especificación AsyncAPI usando la extensión `x-mint`. Agrega `x-mint: content` a un canal para incluir contenido MDX encima de la documentación del canal sin crear un archivo MDX separado.
+
+```yaml {6-8}
+channels:
+  userEvents:
+    address: /events/users
+    description: Eventos de usuario en tiempo real
+    x-mint:
+      content: |
+        ## Descripción general
+        Suscríbete a este canal para recibir eventos de actividad de usuario en tiempo real.
+    messages:
+      userEvent:
+        $ref: '#/components/messages/UserEvent'
+```
+
+La extensión `x-mint: content` es compatible con todos los componentes y el formato MDX de Mintlify.
+
+### Página de canal
 
 Si quieres tener más control sobre el orden de tus canales o necesitas referirte solo a canales específicos, crea un archivo MDX con la propiedad `asyncapi` en el frontmatter.
 

fr/api-playground/asyncapi-setup.mdx

@@ -110,11 +110,48 @@ Pour générer automatiquement des pages pour tous les canaux de votre schéma A
 </Note>
 
 
-<div id="channel-page">
-  ## Page de canal
-</div>
+## Personnaliser les pages de canaux
+
+### Contenu MDX personnalisé
+
+Ajoutez du contenu MDX personnalisé sous le frontmatter de votre page `asyncapi:` pour l'afficher au-dessus de la documentation de canal générée automatiquement. Cela fonctionne de la même manière que le [contenu personnalisé pour les pages OpenAPI](/fr/api-playground/openapi-setup#content).
+
+```mdx
+---
+title: "Canal WebSocket"
+asyncapi: "/path/to/asyncapi.json channelName"
+---
+
+## Prérequis
+
+Vous devez vous authentifier avant de vous connecter à ce canal.
+
+<Note>Ce canal nécessite une clé API valide passée en paramètre de requête.</Note>
+```
+
+### Extension x-mint
+
+Vous pouvez ajouter du contenu aux pages de canal générées automatiquement directement dans votre spécification AsyncAPI à l'aide de l'extension `x-mint`. Ajoutez `x-mint: content` à un canal pour inclure du contenu MDX au-dessus de la documentation du canal sans créer de fichier MDX séparé.
+
+```yaml {6-8}
+channels:
+  userEvents:
+    address: /events/users
+    description: Événements utilisateur en temps réel
+    x-mint:
+      content: |
+        ## Aperçu
+        Abonnez-vous à ce canal pour recevoir les événements d'activité utilisateur en temps réel.
+    messages:
+      userEvent:
+        $ref: '#/components/messages/UserEvent'
+```
+
+L'extension `x-mint: content` est compatible avec tous les composants et le formatage MDX de Mintlify.
+
+### Page de canal
 
-Si vous souhaitez mieux contrôler l’ordre de vos canaux ou ne référencer que certains canaux, créez un fichier MDX avec la propriété `asyncapi` dans le frontmatter.
+Si vous souhaitez mieux contrôler l'ordre de vos canaux ou ne référencer que certains canaux, créez un fichier MDX avec la propriété `asyncapi` dans le frontmatter.
 
 ```mdx
 ---

zh/api-playground/asyncapi-setup.mdx

@@ -110,9 +110,46 @@ keywords: ["asyncapi", "websocket"]
 </Note>
 
 
-<div id="channel-page">
-  ## 频道页面
-</div>
+## 自定义频道页面
+
+### 自定义 MDX 内容
+
+在 `asyncapi:` 页面的 frontmatter 下方添加自定义 MDX 内容，使其显示在自动生成的频道文档上方。这与 [OpenAPI 页面的自定义内容](/zh/api-playground/openapi-setup#content)工作方式相同。
+
+```mdx
+---
+title: "WebSocket 频道"
+asyncapi: "/path/to/asyncapi.json channelName"
+---
+
+## 前提条件
+
+连接此频道前必须先进行身份验证。
+
+<Note>此频道要求将有效的 API 密钥作为查询参数传递。</Note>
+```
+
+### x-mint 扩展
+
+你可以使用 `x-mint` 扩展直接在 AsyncAPI 规范中为自动生成的频道页面添加内容。在频道上添加 `x-mint: content`，无需创建单独的 MDX 文件即可在频道文档上方包含 MDX 内容。
+
+```yaml {6-8}
+channels:
+  userEvents:
+    address: /events/users
+    description: 实时用户事件
+    x-mint:
+      content: |
+        ## 概述
+        订阅此频道以接收实时用户活动事件。
+    messages:
+      userEvent:
+        $ref: '#/components/messages/UserEvent'
+```
+
+`x-mint: content` 扩展支持所有 Mintlify MDX 组件和格式。
+
+### 频道页面
 
 如果你需要更灵活地控制频道的排序，或只想引用特定频道，请创建一个在前言区（frontmatter）中包含 `asyncapi` 属性的 MDX 文件。