Configuración global

El archivo docs.json te permite convertir una colección de archivos Markdown en un sitio de documentación navegable y personalizado. Este archivo de configuración obligatorio controla el estilo, la navigation, integraciones y más. Piénsalo como el plano de tu documentación. La configuración en docs.json se aplica globalmente a todas las páginas.

Configurar tu `docs.json`

Para empezar, solo necesitas especificar theme, name, colors.primary y navigation. Los demás campos son opcionales y puedes agregarlos a medida que crezcan las necesidades de tu documentación. Para una mejor experiencia de edición, incluye la referencia del esquema en la parte superior de tu archivo docs.json. Esto habilita el autocompletado, la validación y las descripciones emergentes útiles en la mayoría de los editores de código:

{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "mint",
  "name": "Tu Documentación",
  "colors": {
    "primary": "#ff0000"
  },
  "navigation": {
    // Tu estructura de navegación
  }
  // El resto de tu configuración
}

Referencia

Esta sección contiene la referencia completa del archivo docs.json.

Personalización

requerido

El tema de diseño de tu sitio.Una de las siguientes: mint, maple, palm, willow, linden, almond, aspen.Consulta Temas para más información.

string

requerido

El nombre de tu proyecto, organización o producto.

object

requerido

Los colores usados en tu documentación. Los colores se aplican de forma diferente según el tema. Si solo proporcionas un color principal, se usará para todos los elementos de color.

Mostrar Colors

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

requerido

El color principal de tu documentación. Generalmente se usa para resaltar en el modo claro, con alguna variación según el tema.Debe ser un código hexadecimal que comience con #.

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

El color usado para el énfasis en el modo oscuro.Debe ser un código hexadecimal que comience con #.

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

El color usado para botones y estados de hover en los modos claro y oscuro, con alguna variación según el tema.Debe ser un código hexadecimal que comience con #.

string

Descripción de tu sitio para SEO e indexación en IA.

string or object

Tu logotipo para los modos claro y oscuro.

Mostrar Logo

string

requerido

Ruta a tu archivo de logotipo para el modo claro. Incluye la extensión del archivo. Ejemplo: /logo.png

string

requerido

Ruta a tu archivo de logotipo para el modo oscuro. Incluye la extensión del archivo. Ejemplo: /logo-dark.png

string (uri)

La URL a la que redirigir al hacer clic en el logotipo. Si no se proporciona, el logotipo enlazará a tu página de inicio. Ejemplo: https://mintlify.com

string or object

Ruta a tu archivo de favicon, incluida la extensión. Se redimensiona automáticamente a los tamaños de favicon apropiados. Puede ser un único archivo o archivos separados para los modos claro y oscuro. Ejemplo: /favicon.png

Mostrar Favicon

string

requerido

Ruta a tu archivo de favicon para el modo claro. Incluye la extensión del archivo. Ejemplo: /favicon.png

string

requerido

Ruta a tu archivo de favicon para el modo oscuro. Incluye la extensión del archivo. Ejemplo: /favicon-dark.png

object

Personalización de miniaturas para redes sociales y vistas previas de página.

Mostrar Thumbnails

"light" | "dark"

El tema visual de tus miniaturas. Si no se especifica, las miniaturas usan el esquema de color de tu sitio definido por el campo colors.

string

Imagen de fondo para tus miniaturas. Puede ser una ruta relativa o una URL absoluta.

object

Configuraciones de estilo visual.

Mostrar Styling

"section" | "breadcrumbs"

El estilo del eyebrow de la página. Elige section para mostrar el nombre de la sección o breadcrumbs para mostrar la ruta de navegación completa. El valor predeterminado es section.

"system" | "dark"

El tema de los bloques de código. Elige system para que coincida con el tema del sitio o dark para bloques de código siempre oscuros. El valor predeterminado es system.

object

Configuración de la biblioteca de íconos.

Mostrar Icons

"fontawesome" | "lucide"

requerido

Biblioteca de íconos que se usará en toda tu documentación. De forma predeterminada es fontawesome.

Puedes especificar una URL a un ícono alojado externamente, la ruta a un archivo de ícono en tu proyecto o código SVG compatible con JSX para cualquier ícono individual, independientemente de la configuración de la biblioteca.

object

Configuración de fuentes para tu documentación. La fuente predeterminada es Inter.

Mostrar Fonts

string

requerido

Familia tipográfica, por ejemplo, “Open Sans”.

number

Peso de la fuente, por ejemplo, 400 o 700. Las fuentes variables admiten pesos precisos como 550.

string (uri)

URL del origen de la fuente, por ejemplo, https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. Google Fonts se carga automáticamente cuando especificas un nombre de family de Google Fonts, por lo que no se necesita una URL de source.

"woff" | "woff2"

Formato del archivo de fuente.

object

Anula la configuración de la fuente específicamente para los encabezados.

Mostrar Heading

string

requerido

Familia tipográfica, por ejemplo, “Open Sans”, “Playfair Display”.

number

Peso de la fuente, por ejemplo, 400 o 700. Las fuentes variables admiten pesos precisos como 550.

string (uri)

"woff" | "woff2"

Formato del archivo de fuente.

object

Anula la configuración de la fuente específicamente para el texto del cuerpo.

Mostrar Body

string

requerido

Familia tipográfica, por ejemplo, “Open Sans”, “Playfair Display”.

number

Peso de la fuente, por ejemplo, 400 o 700. Las fuentes variables admiten pesos precisos como 550.

string (uri)

"woff" | "woff2"

Formato del archivo de fuente.

object

Configuración del conmutador de modo claro/oscuro.

Mostrar Appearance

"system" | "light" | "dark"

Modo de tema predeterminado. Elige system para ajustarte a la configuración del SO del usuario, o light o dark para forzar un modo específico. De forma predeterminada es system.

boolean

Si se debe ocultar el conmutador de modo claro/oscuro. De forma predeterminada es true.

object

Configuración del color y la decoración del fondo.

Mostrar Background

string or object

Imagen de fondo para tu sitio. Puede ser un único archivo o archivos separados para los modos light y dark.

Mostrar Image

string

requerido

Ruta de la imagen de fondo para el modo light. Incluye la extensión del archivo. Ejemplo: /background.png.

string

requerido

Ruta de la imagen de fondo para el modo dark. Incluye la extensión del archivo. Ejemplo: /background-dark.png.

"gradient" | "grid" | "windows"

Decoración de fondo para tu tema.

object

Colores de fondo personalizados para los modos light y dark.

Mostrar Color

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

Color de fondo para el modo light.Debe ser un código hexadecimal que comience con #.

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

Color de fondo para el modo dark.Debe ser un código hexadecimal que comience con #.

Estructura

Elementos de la barra de navegación hacia enlaces externos.

Mostrar Barra de navegación

array of object

Enlaces para mostrar en la barra de navegación.

Mostrar Enlaces

string

requerido

Texto del enlace.

string (uri)

requerido

Destino del enlace. Debe ser una URL externa válida.

string

El icono que se mostrará.Opciones:

Nombre del icono de Font Awesome
Nombre del icono de Lucide
Código SVG (compatible con JSX) envuelto entre llaves
URL a un icono alojado externamente
Ruta a un archivo de icono en tu proyecto

Para iconos SVG personalizados:

Convierte tu SVG usando el convertidor SVGR.
Pega tu código SVG en el campo de entrada de SVG.
Copia el elemento completo <svg>...</svg> del campo de salida JSX.
Envuelve el código SVG compatible con JSX entre llaves: icon={<svg ...> ... </svg>}.
Ajusta height y width según sea necesario.

string

El estilo de icono de Font Awesome. Solo se usa con iconos de Font Awesome.Opciones: regular, solid, light, thin, sharp-solid, duotone, brands.

object

Botón principal de la barra de navegación.

Mostrar Principal

"button" | "github"

requerido

Estilo del botón. Elige button para un botón estándar con label o github para un enlace a un repositorio de GitHub con icon.

string

requerido

Texto del botón. Solo aplica cuando type es button.

string (uri)

requerido

Destino del botón. Debe ser una URL externa. Si type es github, debe ser la URL de un repositorio de GitHub.

La estructura de navegación de tu contenido.

Mostrar Navegación

object

Elementos de navegación globales que aparecen en todas las páginas y secciones.

Mostrar Global

array of object

Configuración del selector de idioma para sitios localizados.

Mostrar Idiomas

"en" | "cn" | "zh" | "zh-Hans" | "zh-Hant" | "es" | "fr" | "ja" | "jp" | "pt" | "pt-BR" | "de" | "ko" | "it" | "ru" | "id" | "ar" | "tr"

requerido

Código de idioma en formato ISO 639-1.

boolean

Indica si este es el idioma predeterminado.

boolean

Indica si se debe ocultar esta opción de idioma de forma predeterminada.

string (uri)

requerido

Ruta válida o enlace externo a la versión en este idioma de tu documentación.

array of object

Configuración del selector de versiones para sitios con varias versiones.

Mostrar Versions

string

requerido

Nombre visible de la versión.Longitud mínima: 1

boolean

Indica si esta es la versión predeterminada.

boolean

Indica si esta opción de versión se oculta de forma predeterminada.

string (uri)

requerido

URL o ruta a esta versión de tu documentación.

array of object

Pestañas de navegación de nivel superior para organizar las secciones principales.

Mostrar Tabs

string

requerido

Nombre visible de la pestaña.Longitud mínima: 1

string

El icono que se mostrará.Opciones:

Nombre del icono de Font Awesome
Nombre del icono de Lucide
Código SVG (compatible con JSX) envuelto entre llaves
URL a un icono alojado externamente
Ruta a un archivo de icono en tu proyecto

Para iconos SVG personalizados:

Convierte tu SVG usando el convertidor SVGR.
Pega tu código SVG en el campo de entrada de SVG.
Copia el elemento completo <svg>...</svg> del campo de salida JSX.
Envuelve el código SVG compatible con JSX entre llaves: icon={<svg ...> ... </svg>}.
Ajusta height y width según sea necesario.

string

El estilo de icono de Font Awesome. Solo se usa con iconos de Font Awesome.Opciones: regular, solid, light, thin, sharp-solid, duotone, brands.

boolean

Indica si se debe ocultar esta pestaña de forma predeterminada.

string (uri)

requerido

URL o ruta de destino de la pestaña.

array of object

Enlaces anclados que aparecen de forma destacada en la navigation de la barra lateral.

Mostrar Anclas

string

requerido

Nombre visible del ancla.Longitud mínima: 1

string

El icono que se mostrará.Opciones:

Nombre del icono de Font Awesome
Nombre del icono de Lucide
Código SVG (compatible con JSX) envuelto entre llaves
URL a un icono alojado externamente
Ruta a un archivo de icono en tu proyecto

Para iconos SVG personalizados:

Convierte tu SVG usando el convertidor SVGR.
Pega tu código SVG en el campo de entrada de SVG.
Copia el elemento completo <svg>...</svg> del campo de salida JSX.
Envuelve el código SVG compatible con JSX entre llaves: icon={<svg ...> ... </svg>}.
Ajusta height y width según sea necesario.

string

El estilo de icono de Font Awesome. Solo se usa con iconos de Font Awesome.Opciones: regular, solid, light, thin, sharp-solid, duotone, brands.

object

Colores personalizados para el ancla.

Mostrar Color

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

Color del ancla para el modo claro.Debe ser un código hexadecimal que comience con #.

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

Color del ancla para el modo oscuro.Debe ser un código hexadecimal que comience con #.

boolean

Si se debe ocultar este ancla de forma predeterminada.

string (uri)

requerido

URL o ruta del destino del ancla.

array of object

Menús desplegables para organizar contenido relacionado.

Mostrar Menús desplegables

Nombre para mostrar del menú desplegable.Longitud mínima: 1

string

El icono que se mostrará.Opciones:

Nombre del icono de Font Awesome
Nombre del icono de Lucide
Código SVG (compatible con JSX) envuelto entre llaves
URL a un icono alojado externamente
Ruta a un archivo de icono en tu proyecto

Para iconos SVG personalizados:

Convierte tu SVG usando el convertidor SVGR.
Pega tu código SVG en el campo de entrada de SVG.
Copia el elemento completo <svg>...</svg> del campo de salida JSX.
Envuelve el código SVG compatible con JSX entre llaves: icon={<svg ...> ... </svg>}.
Ajusta height y width según sea necesario.

string

El estilo de icono de Font Awesome. Solo se usa con iconos de Font Awesome.Opciones: regular, solid, light, thin, sharp-solid, duotone, brands.

boolean

Si ocultar este menú desplegable de forma predeterminada.

string (uri)

requerido

URL o ruta de destino del menú desplegable.

array of object

Selector de idioma para sitios multilingües.

array of object

Selector de versión para sitios con varias versiones.

array of object

Pestañas de navegación de nivel superior tabs.

array of object

Anclas en la barra lateral anchors.

array of object

Menús desplegables para agrupar contenido relacionado.

array of object

Groups para organizar el contenido en secciones.

array of string or object

Páginas individuales pages que componen tu documentación.

object

Configuración de interacción del usuario para los elementos de navegación.

Mostrar Interaction

boolean

Controla el comportamiento de navegación automática al seleccionar grupos de navegación. Configúralo en true para forzar la navegación a la primera página cuando se expanda un grupo de navegación. Configúralo en false para impedir la navegación y solo expandir o contraer el grupo. Déjalo sin definir para usar el comportamiento predeterminado del tema.

object

Contenido del pie de página y enlaces a redes sociales.

Mostrar Footer

object

Perfiles de redes sociales para mostrar en el pie de página. Cada key es el nombre de una plataforma y cada value es la URL de tu perfil. Por ejemplo:

{
  "x": "https://x.com/mintlify"
}

Nombres de propiedades válidos: x, website, facebook, youtube, discord, slack, github, linkedin, instagram, hacker-news, medium, telegram, twitter, x-twitter, earth-americas, bluesky, threads, reddit, podcast

array of object

Enlaces para mostrar en el pie de página.

Mostrar Links

string

Título de la columna.Longitud mínima: 1

array of object

requerido

Enlaces para mostrar en la columna.

Mostrar Items

string

requerido

Texto del enlace.Longitud mínima: 1

string (uri)

requerido

URL de destino del enlace.

object

Banner del sitio, mostrado en la parte superior de las páginas.

Mostrar Banner

string

El contenido del banner. Admite texto sin formato y formato Markdown. Por ejemplo:

{
  "content": "🚀 ¡El banner está activo! [Más información](mintlify.com)"
}

boolean

Indica si los usuarios pueden descartar el banner. El valor predeterminado es false.

array of object

Redirecciones para páginas movidas, renombradas o eliminadas.

Mostrar Redirects

string

requerido

Ruta de origen desde la que redirigir. Ejemplo: /old-page

string

requerido

Ruta de destino a la que redirigir. Ejemplo: /new-page

boolean

Indica si se usa una redirección permanente (301). El valor predeterminado es true.

object

Menú contextual para contenido optimizado con IA e integraciones.

Mostrar Contextual

requerido

Acciones disponibles en el menú contextual. La primera opción aparece como predeterminada.

copy: Copia la página actual como Markdown en el portapapeles.
view: Muestra la página actual como Markdown en una nueva pestaña.
chatgpt: Envía el contenido de la página actual a ChatGPT.
claude: Envía el contenido de la página actual a Claude.
perplexity: Envía el contenido de la página actual a Perplexity.
mcp: Copia la URL de tu servidor MCP en el portapapeles.
cursor: Instala tu servidor MCP alojado en Cursor.
vscode: Instala tu servidor MCP alojado en VSCode.

El menú contextual solo está disponible en las implementaciones de vista previa y de producción.

Configuración de la API

object

Configuración de la documentación de la API y del área de pruebas interactiva.

Mostrar Api

string or array or object

Archivos de especificación OpenAPI para generar la documentación de la API. Puede ser una sola URL/ruta o una matriz de URL/rutas.

Mostrar Openapi

string

URL o ruta a tu archivo de especificación OpenAPI.Longitud mínima: 1

string

Directorio donde buscar archivos OpenAPI.No incluyas una barra inicial.

string or array or object

Archivos de especificación AsyncAPI para generar la documentación de la API. Puede ser una sola URL/ruta o una matriz de URL/rutas.

Mostrar Asyncapi

string

URL o ruta a tu archivo de especificación AsyncAPI.Longitud mínima: 1

string

Directorio donde buscar archivos AsyncAPI.No incluyas una barra inicial.

object

Configuración de visualización de los parámetros de la API.

Mostrar Params

"all" | "closed"

Si expandir todos los parámetros de forma predeterminada. El valor predeterminado es closed.

object

Configuración del área de pruebas de la API.

Mostrar Playground

"interactive" | "simple" | "none"

Modo de visualización del área de pruebas de la API. El valor predeterminado es interactive.

boolean

Si reenviar las solicitudes de la API a través de un servidor proxy. El valor predeterminado es true.

object

Configuración de los ejemplos de API autogenerados.

Mostrar Examples

array of string

Lenguajes de ejemplo para los fragmentos de API autogenerados

"required" | "all"

Si mostrar los parámetros opcionales en los ejemplos de la API. El valor predeterminado es all.

object

Configuración de las páginas de la API generadas a partir de archivos MDX.

Mostrar Mdx

object

Configuración de autenticación para solicitudes de API basadas en MDX.

Mostrar Auth

"bearer" | "basic" | "key" | "cobo"

Método de autenticación para solicitudes de API.

string

Nombre de autenticación para solicitudes de API.

string or array

Configuración del servidor para solicitudes de API.

SEO y búsqueda

object

Configuraciones de indexación de SEO.

Mostrar Seo

object

Metatags añadidos a cada página. Debe ser un par key-value válido. Consulta la referencia de metatags comunes para ver las opciones.

"navigable" | "all"

Especifica qué páginas deben indexar los motores de búsqueda. Elige navigable para indexar solo las páginas que estén en la navigation de tu docs.json o elige all para indexar todas las páginas. De forma predeterminada: navigable.

object

Configuración de la visualización de la búsqueda.

Mostrar Search

string

Texto de marcador de posición que se mostrará en la barra de búsqueda.

Integraciones

object

Integraciones de terceros.

Mostrar Integraciones

object

Integración de Analytics de Amplitude.

Mostrar Amplitude

string

requerido

Tu API key de Amplitude.

object

Integración de enriquecimiento de datos de Clearbit.

Mostrar Clearbit

string

requerido

Tu clave de API de Clearbit.

object

Integración con Fathom Analytics.

Mostrar Fathom

string

requerido

Tu ID del sitio de Fathom.

object

Integración de Front Chat.

Mostrar Frontchat

string

requerido

Tu ID del fragmento de Front Chat.Longitud mínima: 6

object

Integración con Google Analytics 4.

Mostrar Ga4

string matching ^G

requerido

Tu ID de medición de Google Analytics 4.Debe coincidir con el patrón: ^G

object

Integración con Google Tag Manager.

Mostrar Gtm

string matching ^G

requerido

Tu ID de etiqueta de Google Tag Manager.Debe coincidir con el patrón: ^G

object

Integración con Heap Analytics.

Mostrar Heap

string

requerido

Tu ID de la aplicación de Heap.

object

Integración de Hotjar.

Mostrar Hotjar

string

requerido

Tu ID de Hotjar.

string

requerido

La versión del script de Hotjar.

object

Integración con Intercom.

Mostrar Intercom

string

requerido

Tu ID de la app de Intercom.Longitud mínima: 6

object

Integración con Koala.

Mostrar Koala

string

requerido

Tu clave de API pública de Koala.Longitud mínima: 2

object

Integración con LogRocket.

Mostrar Logrocket

string

requerido

Tu ID de aplicación de LogRocket.

object

Integración con Mixpanel.

Mostrar Mixpanel

string

requerido

Tu token de proyecto de Mixpanel.

object

Integración con Osano.

Mostrar Osano

string

requerido

El source del script de Osano.

object

Integración de Pirsch Analytics.

Mostrar Pirsch

string

requerido

Tu ID de Pirsch.

object

Integración con PostHog.

Mostrar Posthog

string matching ^phc\_

requerido

Tu clave de API de PostHog.Debe coincidir con el patrón: ^phc_

string (uri)

Tu host de la API de PostHog.

object

Integración de Plausible Analytics.

Mostrar Plausible

string

requerido

Tu domain de Plausible.

string

Tu servidor de Plausible.

object

Integración con Segment.

Mostrar Segment

string

requerido

Tu key de Segment.

object

Configuración de la telemetría.

Mostrar Telemetría

boolean

Indica si se habilita la telemetría.

object

Configuración de cookies.

Mostrar Cookies

string

key para cookies.

string

value para cookies.

Errores

object

Configuración para el manejo de errores.

Mostrar Errores

object

Manejo del error 404 “Página no encontrada”.

Mostrar 404

boolean

Indica si se debe redirigir automáticamente a la página principal cuando no se encuentra una página.

string

Título personalizado para la página de error 404.

string

Descripción personalizada para la página de error 404. Admite formato Markdown.

Ejemplos

Ejemplo básico
Ejemplo de API interactivo
Ejemplo multilingüe

docs.json

{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "maple",
  "name": "Example Co.",
  "description": "Example Co. es una empresa que proporciona contenido de ejemplo y texto de marcador de posición.",
  "colors": {
    "primary": "#3B82F6",
    "light": "#F8FAFC",
    "dark": "#0F172A"
  },
  "navigation": {
    "dropdowns": [
      {
        "dropdown": "Documentación",
        "icon": "book",
        "description": "Cómo usar el producto de Example Co.",
        "groups": [
          {
            "group": "Primeros pasos",
            "pages": [
              "index",
              "quickstart"
            ]
          },
          {
            "group": "Personalización",
            "pages": [
              "settings",
              "users",
              "features"
            ]
          },
          {
            "group": "Facturación",
            "pages": [
              "billing/overview",
              "billing/payments",
              "billing/subscriptions"
            ]
          }
        ]
      },
      {
        "dropdown": "Cambios",
        "icon": "history",
        "description": "Actualizaciones y cambios",
        "pages": [
          "changelog"
        ]
      }
    ]
  },
  "logo": {
    "light": "/logo-light.svg",
    "dark": "/logo-dark.svg",
    "href": "https://example.com"
  },
  "navbar": {
    "links": [
      {
        "label": "Comunidad",
        "href": "https://example.com/community"
      }
    ],
    "primary": {
      "type": "button",
      "label": "Comenzar",
      "href": "https://example.com/start"
    }
  },
  "footer": {
    "socials": {
      "x": "https://x.com/example",
      "linkedin": "https://www.linkedin.com/company/example",
      "github": "https://github.com/example",
      "slack": "https://example.com/community"
    },
    "links": [
      {
        "header": "Recursos",
        "items": [
          {
            "label": "Clientes",
            "href": "https://example.com/customers"
          },
          {
            "label": "Empresarial",
            "href": "https://example.com/enterprise"
          },
          {
            "label": "Solicitar vista previa",
            "href": "https://example.com/preview"
          }
        ]
      },
      {
        "header": "Empresa",
        "items": [
          {
            "label": "Empleos",
            "href": "https://example.com/careers"
          },
          {
            "label": "Blog",
            "href": "https://example.com/blog"
          },
          {
            "label": "Política de privacidad",
            "href": "https://example.com/legal/privacy"
          }
        ]
      }
    ]
  },
  "integrations": {
    "ga4": {
      "measurementId": "G-XXXXXXXXXX"
    },
    "koala": {
      "publicApiKey": "pk_example_key_123"
    },
    "telemetry": {
      "enabled": true
    },
    "cookies": {
      "key": "example_cookie_key",
      "value": "example_cookie_value"
    }
  },
  "contextual": {
    "options": [
      "copy",
      "view",
      "chatgpt",
      "claude"
    ]
  },
  "errors": {
    "404": {
      "redirect": false,
      "title": "No se puede encontrar",
      "description": "¿Qué **pasó** con esta _página_?"
    }
  }
}

docs.json

{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "maple",
  "name": "Example Co.",
  "description": "Example Co. es una empresa que proporciona contenido de ejemplo y texto de marcador de posición.",
  "colors": {
    "primary": "#3B82F6",
    "light": "#F8FAFC",
    "dark": "#0F172A"
  },
  "navigation": {
    "dropdowns": [
      {
        "dropdown": "Documentación",
        "icon": "book",
        "description": "Cómo usar el producto de Example Co.",
        "groups": [
          {
            "group": "Primeros pasos",
            "pages": [
              "index",
              "quickstart"
            ]
          },
          {
            "group": "Personalización",
            "pages": [
              "settings",
              "users",
              "features"
            ]
          },
          {
            "group": "Facturación",
            "pages": [
              "billing/overview",
              "billing/payments",
              "billing/subscriptions"
            ]
          }
        ]
      },
      {
        "dropdown": "Referencia de API",
        "icon": "terminal",
        "description": "Cómo usar la API de Example Co.",
        "groups": [
          {
            "group": "Referencia de API",
            "pages": [
              "api-reference/introduction"
            ]
          },
          {
            "group": "Endpoints",
            "openapi": {
              "source": "openapi.json"
            }
          }
        ]
      },
      {
        "dropdown": "Cambios",
        "icon": "history",
        "description": "Actualizaciones y cambios",
        "pages": [
          "changelog"
        ]
      }
    ]
  },
  "api": {
    "playground": {
      "display": "interactive"
    },
    "examples": {
      "languages": ["javascript", "curl", "python"]
    }
  },
  "logo": {
    "light": "/logo-light.svg",
    "dark": "/logo-dark.svg",
    "href": "https://example.com"
  },
  "navbar": {
    "links": [
      {
        "label": "Comunidad",
        "href": "https://example.com/community"
      }
    ],
    "primary": {
      "type": "button",
      "label": "Comenzar",
      "href": "https://example.com/start"
    }
  },
  "footer": {
    "socials": {
      "x": "https://x.com/example",
      "linkedin": "https://www.linkedin.com/company/example",
      "github": "https://github.com/example",
      "slack": "https://example.com/community"
    },
    "links": [
      {
        "header": "Recursos",
        "items": [
          {
            "label": "Clientes",
            "href": "https://example.com/customers"
          },
          {
            "label": "Empresarial",
            "href": "https://example.com/enterprise"
          },
          {
            "label": "Solicitar Vista Previa",
            "href": "https://example.com/preview"
          }
        ]
      },
      {
        "header": "Empresa",
        "items": [
          {
            "label": "Carreras",
            "href": "https://example.com/careers"
          },
          {
            "label": "Blog",
            "href": "https://example.com/blog"
          },
          {
            "label": "Política de Privacidad",
            "href": "https://example.com/legal/privacy"
          }
        ]
      }
    ]
  },
  "integrations": {
    "ga4": {
      "measurementId": "G-XXXXXXXXXX"
    },
    "koala": {
      "publicApiKey": "pk_example_key_123"
    },
    "telemetry": {
      "enabled": true
    },
    "cookies": {
      "key": "example_cookie_key",
      "value": "example_cookie_value"
    }
  },
  "contextual": {
    "options": [
      "copy",
      "view",
      "chatgpt",
      "claude"
    ]
  },
  "errors": {
    "404": {
      "redirect": false,
      "title": "No se puede encontrar",
      "description": "¿Qué **pasó** con esta _página_?"
    }
  }
}

docs.json

{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "maple",
  "name": "Example Co.",
  "description": "Example Co. es una empresa que proporciona contenido de ejemplo y texto de marcador de posición.",
  "colors": {
    "primary": "#3B82F6",
    "light": "#F8FAFC",
    "dark": "#0F172A"
  },
  "navigation": {
    "global": {
      "anchors": [
        {
          "anchor": "Documentación",
          "href": "https://mintlify.com/docs"
        },
        {
          "anchor": "Registro de cambios",
          "href": "https://mintlify.com/docs/changelog"
        }
      ]
    },
    "languages": [ 
      {
        "language": "en",
        "dropdowns": [
          {
            "dropdown": "Documentación",
            "icon": "book",
            "description": "Cómo usar el producto de Example Co.",
            "pages": [
              {
                "group": "Primeros pasos",
                "pages": ["index", "quickstart"]
              },
              {
                "group": "Personalización",
                "pages": ["settings", "users", "features"]
              },
              {
                "group": "Facturación",
                "pages": [
                  "billing/overview",
                  "billing/payments",
                  "billing/subscriptions"
                ]
              }
            ]
          },
          {
            "dropdown": "Registro de cambios",
            "icon": "history",
            "description": "Actualizaciones y cambios",
            "pages": ["changelog"]
          }
        ]
      },
      {
        "language": "es",
        "dropdowns": [
          {
            "dropdown": "Documentación",
            "icon": "book",
            "description": "Cómo usar el producto de Example Co.",
            "pages": [
              {
                "group": "Primeros pasos",
                "pages": ["es/index", "es/quickstart"]
              },
              {
                "group": "Personalización",
                "pages": ["es/settings", "es/users", "es/features"]
              },
              {
                "group": "Facturación",
                "pages": [
                  "es/billing/overview",
                  "es/billing/payments",
                  "es/billing/subscriptions"
                ]
              }
            ]
          },
          {
            "dropdown": "Registro de cambios",
            "icon": "history",
            "description": "Actualizaciones y cambios",
            "pages": ["es/changelog"]
          }
        ]
      }
    ]
  },
  "logo": {
    "light": "/logo-light.svg",
    "dark": "/logo-dark.svg",
    "href": "https://example.com"
  },
  "navbar": {
    "links": [
      {
        "label": "Comunidad",
        "href": "https://example.com/community"
      }
    ],
    "primary": {
      "type": "button",
      "label": "Comenzar",
      "href": "https://example.com/start"
    }
  },
  "footer": {
    "socials": {
      "x": "https://x.com/example",
      "linkedin": "https://www.linkedin.com/company/example",
      "github": "https://github.com/example",
      "slack": "https://example.com/community"
    },
    "links": [
      {
        "header": "Recursos",
        "items": [
          {
            "label": "Clientes",
            "href": "https://example.com/customers"
          },
          {
            "label": "Empresarial",
            "href": "https://example.com/enterprise"
          },
          {
            "label": "Solicitar vista previa",
            "href": "https://example.com/preview"
          }
        ]
      },
      {
        "header": "Empresa",
        "items": [
          {
            "label": "Empleos",
            "href": "https://example.com/careers"
          },
          {
            "label": "Blog",
            "href": "https://example.com/blog"
          },
          {
            "label": "Política de privacidad",
            "href": "https://example.com/legal/privacy"
          }
        ]
      }
    ]
  },
  "integrations": {
    "ga4": {
      "measurementId": "G-XXXXXXXXXX"
    },
    "koala": {
      "publicApiKey": "pk_example_key_123"
    },
    "telemetry": {
      "enabled": true
    },
    "cookies": {
      "key": "example_cookie_key",
      "value": "example_cookie_value"
    }
  },
  "contextual": {
    "options": ["copy", "view", "chatgpt", "claude"]
  },
  "errors": {
    "404": {
      "redirect": false,
      "title": "No se pudo encontrar",
      "description": "¿Qué **pasó** con esta _página_?"
    }
  }
}

Actualización desde `mint.json`

Si tu proyecto de documentación usa el archivo en desuso mint.json, sigue estos pasos para actualizar a docs.json.

Instalar o actualizar la CLI

Si aún no has instalado la CLI, instálala ahora:

npm i -g mint

yarn global add mint

pnpm add -g mint

Si ya tienes instalada la CLI, asegúrate de que esté actualizada:

mint update

Crear tu archivo docs.json

En tu repositorio de documentación, ejecuta:

mint upgrade

Este comando creará un archivo docs.json a partir de tu mint.json existente. Revisa el archivo generado para asegurarte de que toda la configuración sea correcta.

Eliminar tu archivo mint.json

Después de verificar que tu docs.json esté configurado correctamente, puedes eliminar de forma segura tu antiguo archivo mint.json.

Primeros pasos

Configuración básica

Optimización de IA

Componentes

Páginas de API

Autenticación y personalización

Guías

Integraciones

Control de versiones y CI/CD

Configuración global

Configurar tu `docs.json`

Referencia

Personalización

Estructura

Configuración de la API

SEO y búsqueda

Integraciones

Errores

Ejemplos

Actualización desde `mint.json`

​Configurar tu docs.json

​Referencia

​Personalización

​Estructura

​Configuración de la API

​SEO y búsqueda

​Integraciones

​Errores

​Ejemplos

​Actualización desde mint.json

Configurar tu `docs.json`

Referencia

Personalización

Estructura

Configuración de la API

SEO y búsqueda

Integraciones

Errores

Ejemplos

Actualización desde `mint.json`