Saltar al contenido principal
Configura cómo se comporta la barra de búsqueda en tu sitio de documentación alojado en Mintlify. Estos ajustes solo afectan a la búsqueda integrada. No cambian cómo los motores de búsqueda externos indexan tus páginas.

Aumentar la clasificación de búsqueda

Usa boost para sesgar la clasificación de la búsqueda integrada en páginas o secciones específicas. El valor es un multiplicador numérico aplicado a la puntuación de relevancia de cada fragmento: boost: 3 hace que un fragmento sea tres veces más relevante de lo que sería sin un boost.

Aumentar una sola página

Configura boost en el frontmatter de una página para multiplicar su clasificación de búsqueda.

Aumentar un grupo de navegación

Configura boost en un grupo dentro de la navegación de tu docs.json para aplicar el multiplicador a cada página que contiene.
Una página hereda el factor de boost del ancestro más cercano que lo establece. Una página secundaria o un grupo anidado puede sobrescribir el boost heredado configurando su propio valor de boost. El boost del frontmatter de una página siempre prevalece sobre un valor heredado de la navegación.

Despriorizar contenido

Usa un valor inferior a 1 para empujar las páginas más abajo en los resultados de búsqueda. Por ejemplo, boost: 0.5 reduce a la mitad la puntuación de relevancia de una página en relación con otras páginas. Un boost de 1 equivale a no aplicar boost.
Los factores de boost se combinan con la puntuación de relevancia existente. Úsalos con moderación. Multiplicadores grandes pueden hacer que páginas menos relevantes dominen los resultados de búsqueda y degraden la calidad general de la búsqueda.
boost acepta cualquier número positivo. En la práctica, mantén los valores entre 0.1 y 10:
  • 0.1–0.9: despriorizar contenido heredado, obsoleto o complementario.
  • 1: sin cambios (equivalente a omitir boost).
  • 2–5: priorizar una página de aterrizaje clave, una guía de inicio rápido o una referencia muy visitada.
  • 5–10: reservar para un puñado de páginas de nivel superior que casi siempre deberían aparecer primero.
Evita valores superiores a 10. Los multiplicadores muy grandes desbordan la puntuación de relevancia subyacente y hacen que las páginas con boost aparezcan incluso cuando no coinciden bien con la consulta.

Cómo interactúa boost con las coincidencias en el título

La búsqueda ordena los resultados en dos pasos:
  1. La búsqueda agrupa los resultados según lo bien que coinciden con la consulta. Las páginas cuyo título coincide con la consulta forman los grupos más altos, seguidas de las coincidencias en los encabezados de sección y las coincidencias de frase exacta en el texto. Las páginas que solo coinciden parcialmente con la consulta forman el grupo más bajo.
  2. Dentro de cada grupo, la búsqueda ordena los resultados por puntuación de relevancia, que boost multiplica.
Un boost reordena los resultados dentro de un grupo, pero no mueve un resultado a un grupo más alto. Una página con boost cuyo título no contiene el término de búsqueda sigue apareciendo por debajo de una página sin boost cuyo título sí lo contiene. Para que una página aparezca primero para un término, incluye el término en el title de la página. Agregar el término a keywords mejora la puntuación de relevancia de la página, pero no cuenta como una coincidencia en el título. Las páginas son buscables de forma predeterminada. El campo searchable es opcional y su valor predeterminado es true. Establece searchable: false en el frontmatter de una página para excluirla de los resultados de búsqueda de tu sitio de documentación. searchable es un campo solo a nivel de página: para excluir todas las páginas de una pestaña o grupo de navegación, oculta la pestaña o el grupo en su lugar. Consulta Páginas ocultas para conocer los controles a nivel de pestaña y grupo.
A diferencia de noindex, searchable: false no afecta el SEO externo. La página sigue:
  • Siendo rastreable por motores de búsqueda externos
  • Listada en tu sitemap.xml
Se excluye de los resultados de búsqueda de tu sitio de documentación y del contexto del asistente de IA. Usa searchable: false para páginas que deben seguir accesibles mediante enlaces directos o motores de búsqueda externos, pero que no deberían aparecer cuando los usuarios buscan dentro de tus docs. Es útil para páginas de referencia detalladas, contenido heredado o material de apoyo que de otro modo desplazaría resultados más relevantes. Para excluir una página tanto de la búsqueda integrada como de la indexación externa, usa noindex: true en su lugar.

Máximo de resultados de búsqueda

Controla cuántos resultados devuelve la barra de búsqueda por consulta desde tu dashboard. El valor predeterminado es 6 resultados. Puedes establecer cualquier valor entre 1 y 100. Ve a la página de configuración Sitio en tu dashboard. En la sección “Search”, establece Results per query al valor que quieras. Los valores más altos muestran más coincidencias por consulta, lo cual es útil para sitios con una cobertura temática amplia donde los usuarios esperan revisar muchos candidatos. Los valores más bajos mantienen compacto el panel de resultados y dirigen a los usuarios hacia la coincidencia mejor clasificada.

Fragmentos de resultados

Activa Result snippets para mostrar una vista previa de una sola línea del contenido coincidente debajo de cada resultado de búsqueda, además del título de la página y las migas de pan. El fragmento se centra en la primera coincidencia de la consulta del usuario y resalta los términos coincidentes. Cuando un resultado no tiene coincidencia con la consulta, o el usuario aún no ha escrito una consulta, el fragmento muestra el inicio del contenido de la página. Los fragmentos de resultados ayudan a los usuarios a distinguir resultados con títulos parecidos al mostrar dónde aparece la consulta en su contexto. Déjalos desactivados si prefieres un panel de resultados más compacto. Activa o desactiva los fragmentos de resultados en la página de configuración Sitio en tu dashboard. Esta opción está desactivada por defecto.

Resultados de búsqueda a página completa

Activa Full-page search results para que tu sitio tenga una página de resultados de búsqueda dedicada en /search. Cuando está activado, la barra de búsqueda muestra una opción Search for “query” que abre la página de resultados para la consulta actual. La página muestra hasta 50 resultados, 10 por página, y la URL incluye la consulta (por ejemplo, /search?q=authentication) para que los usuarios puedan guardarla en marcadores o compartirla. En sitios con varios idiomas, cada idioma que no sea el predeterminado tiene su propia página de resultados en /{language}/search, como /fr/search. Activa o desactiva los resultados de búsqueda a página completa en la página de configuración Site de tu dashboard. Esta opción está desactivada de forma predeterminada.
Activar los resultados de búsqueda a página completa reserva la ruta /search. Si tu sitio ya tiene una página en /search o /{language}/search, la página de resultados integrada la reemplaza. Mueve esa página a otra ruta antes de activar esta opción.
Mintlify excluye la página de resultados de los motores de búsqueda externos con noindex.

Filtros de búsqueda

Los filtros de búsqueda requieren un plan Enterprise.
Los filtros de búsqueda añaden desplegables de producto y versión a los resultados de búsqueda para que los usuarios puedan restringir los resultados a un solo producto o versión. Los filtros son útiles para sitios que mantienen productos o versiones distintos, donde una consulta de búsqueda podría devolver coincidencias en contenido que el usuario no está buscando. Habilita o deshabilita los filtros de búsqueda en la página de configuración Sitio de tu dashboard. Los desplegables que aparecen dependen de tu configuración de navegación.
  • El filtro de producto aparece cuando tu navegación define más de un producto.
  • El filtro de versión aparece cuando tu navegación define versiones.
Si tu navegación no tiene productos ni versiones, habilitar los filtros de búsqueda no tiene ningún efecto visible.

Filtros en la página de resultados de búsqueda

Cuando también activas los resultados de búsqueda a página completa, la página de resultados muestra los mismos filtros Product y Version que la barra de búsqueda. Si un usuario selecciona filtros en la barra de búsqueda y luego abre la página de resultados, la página de resultados conserva esos filtros. La URL de la página de resultados incluye los filtros seleccionados, por ejemplo /search?q=authentication&product=api&version=v2. Los usuarios pueden guardar la URL en marcadores o compartirla y obtener los mismos resultados filtrados. Cambiar el filtro de producto borra el filtro de versión, porque cada producto puede tener sus propias versiones.