Saltar al contenido principal
El menú contextual ofrece acceso rápido a contenido optimizado con IA e integraciones directas con herramientas de IA populares. Cuando los usuarios seleccionan el menú contextual en cualquier página, pueden copiar contenido como contexto para herramientas de IA o abrir conversaciones en ChatGPT, Claude, Perplexity, Google AI Studio, Grok, Devin, Devin Desktop o una herramienta personalizada de su elección, con su documentación ya cargada como contexto.
Combina el menú contextual con tu archivo skill.md alojado y tu servidor MCP para que los usuarios puedan instalar todas las capacidades de tu producto en sus herramientas de IA, no solo la página que están leyendo.
El menú contextual incluye varias opciones preconfiguradas que puedes habilitar agregando su identificador a tu configuración.
El menú contextual expandido que muestra los elementos del menú Copiar página, Ver como Markdown, Abrir en ChatGPT y Abrir en Claude.
La opción downloadApiSpec solo aparece en páginas de referencia de API (páginas cuyo frontmatter declara api, openapi o asyncapi). En despliegues con autenticación o autenticación de usuario habilitada, solo los lectores autenticados pueden descargar la especificación.

​
Activar el menú contextual

Añade el campo contextual a tu archivo docs.json y especifica qué opciones quieres incluir.

​
Ubicación de visualización

De forma predeterminada, el menú contextual aparece en el encabezado de la página. Puedes configurarlo para que se muestre en la barra lateral de la tabla de contenidos mediante la opción display.

​
Agregar opciones personalizadas

Crea opciones personalizadas en el menú contextual agregando un objeto al arreglo options. Cada opción personalizada requiere estas propiedades:
​
title
string
requerido
El título de la opción.
​
description
string
requerido
La descripción de la opción. Se muestra debajo del título cuando el menú contextual se expande.
Debes proporcionar icon o src.
​
icon
string
El icono que se mostrará desde una biblioteca de iconos.Options:
​
src
string
Ruta o URL de una imagen para usar como icono. Usa src en lugar de icon cuando quieras utilizar una imagen personalizada en lugar de un icono de una biblioteca.Options:
  • Ruta a un archivo de imagen en tu proyecto (por ejemplo, /images/mi-icono.svg)
  • URL de una imagen alojada externamente (por ejemplo, https://example.com/icon.png)
​
iconType
string
The Font Awesome icon style. Only used with Font Awesome icons.Options: regular, solid, light, thin, sharp-solid, duotone, brands.
​
href
string | object
requerido
El href de la opción. Usa una cadena para enlaces simples o un objeto para enlaces dinámicos con parámetros de búsqueda.
Ejemplo de opción personalizada:

​
Sobrescribir en páginas individuales

Sobrescribe el menú contextual global en una página específica añadiendo un campo contextual al frontmatter de la página. Úsalo para mostrar acciones específicas de la página, como download-pdf en una página de términos de servicio, u ocultar el menú por completo en una landing page. El objeto contextual a nivel de página reemplaza al global en esa página. Omite el campo para heredar docs.json, o define options: [] para desactivar el menú contextual en esa página.
Se aplican los mismos campos y reglas de validación que en docs.json, incluidas las opciones personalizadas y la configuración display. Si la sobrescritura de página no es válida, Mintlify utiliza la configuración global de contextual.

​
Ejemplos de opciones personalizadas