Saltar al contenido principal
Usa banners para mostrar anuncios, actualizaciones o notificaciones importantes en todo tu sitio de documentación. Los banners aparecen en la parte superior de cada página, admiten formato Markdown y puedes hacer que sean descartables. Los banners usan el color definido por la propiedad colors.dark en tu docs.json. Para añadir un banner, usa la propiedad banner en tu docs.json: 
"banner": {
  "content": "🚀 ¡La versión 2.0 ya está disponible! Consulta nuestro [registro de cambios](/changelog) para más detalles.",
  "dismissible": true 
}
También puedes configurar banners por idioma configurando banner en navigation.languages. Consulta Banners específicos por idioma.

​
Propiedades

​
content
string
requerido
El contenido de texto que se muestra en el banner. Admite formato MDX básico, incluyendo enlaces, negrita y cursiva. No se admiten componentes personalizados.
​
dismissible
boolean
Indica si los usuarios pueden descartar el banner. Cuando es true, aparece un botón de cierre. Si un usuario descarta el banner, permanece oculto para él hasta que actualices el contenido del banner. De manera predeterminada, es false.

​
Banners específicos por idioma

Configura distintos banners para cada idioma en tu documentación. Define los banners específicos por idioma en el array navigation.languages de tu docs.json. 
{
  "navigation": {
    "languages": [
      {
        "language": "en",
        "banner": {
          "content": "🚀 Version 2.0 is now live! See our [changelog](/en/changelog) for details.",
          "dismissible": true
        },
        "groups": [
          {
            "group": "Getting started",
            "pages": ["en/overview", "en/quickstart"]
          }
        ]
      },
      {
        "language": "es",
        "banner": {
          "content": "🚀 ¡La versión 2.0 ya está disponible! Consulta nuestro [registro de cambios](/es/changelog) para más detalles.",
          "dismissible": true
        },
        "groups": [
          {
            "group": "Getting started",
            "pages": ["es/overview", "es/quickstart"]
          }
        ]
      }
    ]
  },
  "banner": {
    "content": "🚀 ¡La versión 2.0 ya está disponible!",
    "dismissible": true
  }
}

​
Comportamiento de respaldo

Los banners siguen un orden de prioridad al decidir qué contenido mostrar:
  1. Banner específico por idioma: Si el idioma actual tiene una configuración de banner, esta tendrá prioridad.
  2. Banner global: Si no existe un banner específico por idioma, se muestra el banner global.