Saltar al contenido principal
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, navigation, integrations y más. Piénsalo como el plano de tu documentación. Los ajustes en docs.json se aplican 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 añadirlos a medida que crezcan las necesidades de tu documentación. Para obtener la 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 sugerencias ú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

​
theme
required
El tema de diseño de tu sitio.Una de las siguientes opciones: mint, maple, palm, willow, linden, almond, aspen.Consulta Temas para obtener más información.
​
name
string
required
El nombre de tu proyecto, organización o producto.
​
colors
object
required
Los colores utilizados en tu documentación. Los colores se aplican de forma diferente según el tema. Si solo proporcionas un color primario, se usará para todos los elementos relacionados con el color.
​
description
string
Descripción de tu sitio para SEO e indexación por IA.
Configura tu logotipo para los modos claro y oscuro.
​
favicon
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 archivo único o archivos separados para los modos claro y oscuro. Ejemplo: /favicon.png
​
thumbnails
object
Personalización de miniaturas para redes sociales y vistas previas de página.
​
styling
object
Configuraciones de estilo visual.
​
icons
object
Configuración de la biblioteca de iconos.
​
fonts
object
Configuración tipográfica para tu documentación. La fuente predeterminada es Inter.
​
appearance
object
Configuración del conmutador de modo claro/oscuro.
​
background
object
Configuración del color y la decoración del fondo.

​
Estructura

​
navbar
object
Elementos de la barra de navegación que apuntan a enlaces externos.
​
navigation
object
required
La estructura de navegación de tu contenido.
​
interaction
object
Configuración de interacción del usuario para los elementos de navegación.
​
footer
object
Contenido del pie de página y enlaces a redes sociales.
​
banner
object
Banner del sitio mostrado en la parte superior de las páginas.
​
redirects
array of object
Redirecciones para páginas movidas, renombradas o eliminadas.
​
contextual
object
Menú contextual para contenido optimizado con IA e integraciones.

​
Configuraciones de la API

​
api
object
Configuración de la documentación de la API y del área de pruebas interactiva.
​
seo
object
Configuraciones de indexación para SEO.
​
search
object
Configuraciones de visualización de la búsqueda.

​
Integraciones

​
Integraciones
object
Integraciones de terceros.

​
Errores

​
errors
object
Configuración del manejo de errores.

​
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_?"
    }
  }
}

​
Actualización desde mint.json

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

Instala o actualiza la CLI

Si aún no has instalado la CLI, instálala ahora:
npm i -g mint
Si ya tienes la CLI instalada, asegúrate de que esté actualizada:
mint update
2

Crea 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.
3

Elimina 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.
⌘I