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.
Configura boost en el frontmatter de una página para multiplicar su clasificación de búsqueda.
boost en un grupo dentro de la navegación de tu docs.json para aplicar el multiplicador a cada página que contiene.
boost. El boost del frontmatter de una página siempre prevalece sobre un valor heredado de la navegación.
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 omitirboost).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.
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.
La búsqueda ordena los resultados en dos pasos:
- 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.
- Dentro de cada grupo, la búsqueda ordena los resultados por puntuación de relevancia, que
boostmultiplica.
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.
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
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.
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.
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.
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.
Mintlify excluye la página de resultados de los motores de búsqueda externos con noindex.
Los filtros de búsqueda requieren un plan Enterprise.
- 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.
/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.