Páginas ocultas

Algunas páginas no deberían estar en la barra lateral pública: borradores, manuales internos, guías obsoletas a las que aún necesitas enlazar. Las páginas ocultas siguen siendo accesibles mediante URL directa, pero desaparecen de la navegación, la búsqueda, tu sitemap y el contexto de IA que se proporciona a los LLM.

Ocultar una sola página

Agrega hidden: true al frontmatter de la página:

---
title: Internal handbook
hidden: true
---

La página se renderiza normalmente cuando alguien visita su URL, pero Jamdesk:

La elimina de la barra lateral
Agrega <meta name="robots" content="noindex, follow"> para que los motores de búsqueda la omitan
La excluye de sitemap.xml, llms.txt, llms-full.txt y de la búsqueda en el sitio

Ocultar un grupo o pestaña completos

Configura "hidden": true en un grupo o pestaña en docs.json:

{
  "navigation": {
    "tabs": [
      {
        "tab": "Public",
        "groups": [{ "group": "Guides", "pages": ["intro", "quickstart"] }]
      },
      {
        "tab": "Internal",
        "hidden": true,
        "groups": [{ "group": "Runbooks", "pages": ["oncall", "postmortems"] }]
      }
    ]
  }
}

Cada página bajo el nodo oculto hereda esta regla. El mismo indicador funciona en tabs, groups, anchors, dropdowns, products, languages y versions.

Mantener las páginas ocultas en la búsqueda

Si quieres que una pestaña o grupo oculto quede fuera de la barra lateral pero siga indexado para la búsqueda en el sitio, las respuestas de IA y el sitemap, agrega "searchable": true:

{
  "tab": "Internal",
  "hidden": true,
  "searchable": true,
  "groups": [{ "group": "Runbooks", "pages": ["oncall"] }]
}

El hidden: true del frontmatter de una página hija sigue prevaleciendo. searchable solo reabre los descendientes que no se hayan excluido ellos mismos.

Mantener una página fuera solo de la búsqueda

A veces una página debe permanecer en la barra lateral y seguir siendo indexable, pero dejar de aparecer cuando alguien busca o hace una pregunta. Agrega search: false a su frontmatter:

---
title: Legacy v1 endpoints
search: false
---

La página conserva su lugar en la navegación, tu sitemap, llms.txt y tu feed RSS, y los motores de búsqueda siguen indexándola. Lo que deja son las superficies de búsqueda: la búsqueda en el sitio, las respuestas del chat de IA y el servidor MCP.

search: false hace lo contrario de hidden: true. hidden saca una página de la navegación y de las superficies de indexación; search: false deja todo eso intacto y solo impide que la página sea recuperada. No lo confundas con el searchable a nivel de navegación, que reincorpora las páginas ocultas a la búsqueda.

Qué parte de una página se indexa

La búsqueda no indexa una página como un solo bloque. La indexa sección por sección: cada encabezado se convierte en su propia entrada de búsqueda, de modo que un lector que busca «Límites de tasa» llega a ese encabezado en lugar de al principio de una página larga.

Se aplican dos límites a esto, y ambos son automáticos:

Límite	Valor	Qué ocurre al superarlo
Entradas por página	50	Las secciones se indexan en el orden de la página. Una vez usada la 50.ª, todas las secciones restantes quedan fuera de la búsqueda.
Texto por sección	Los primeros 300 caracteres	El texto más allá de ese punto en una sección no se compara.

La propia página ocupa una de las 50 posiciones, por lo que se indexan 49 secciones.

El límite existe porque la búsqueda pondera cada entrada frente al resto de tu índice. Una página que genera cientos de entradas desplaza a las demás de los resultados: un changelog generado automáticamente puede representar por sí solo la mitad de un índice y sacar de la primera pantalla a páginas realmente relevantes.

Una página que supera el límite se sigue renderizando por completo. Solo sus secciones posteriores dejan de ser localizables, y nada en la página se lo indica a tus lectores.

Si una página tiene más de unos 50 encabezados, divídela en varias páginas —lo cual mejora la navegación de todos modos— o, si se genera automáticamente y nadie la busca a mano, agrega search: false para excluir toda la página del índice.

Para colocar un término donde la búsqueda pueda ponderarlo correctamente, usa el título de la página (el más ponderado), luego un encabezado, luego la descripción. El texto del cuerpo tiene la ponderación más baja, y solo cuentan sus primeros 300 caracteres por sección.

seo.metatags.keywords no alimenta la búsqueda en el sitio. Genera una etiqueta HTML <meta name="keywords">, que Google ha declarado que ignora para el posicionamiento. No hay forma de asociar términos de búsqueda adicionales a una página: coloca las palabras que quieres que coincidan en el título, un encabezado o la descripción.

Controles a nivel de proyecto

Ambos indicadores se encuentran bajo seo en docs.json:

Indicador	Valor predeterminado	Efecto
`seo.indexing`	`"navigable"`	Solo las páginas listadas en tu navegación aparecen en los artefactos. Configúralo en `"all"` para incluir todos los archivos MDX de tu repositorio.
`seo.indexHiddenPages`	`false`	Configúralo en `true` para incluir las páginas `hidden: true` en el sitemap, llms.txt y la búsqueda, y eliminar la etiqueta auto-noindex.

Ejemplo:

{
  "seo": {
    "indexing": "all"
  }
}

Referencia rápida

Escenario	Frontmatter	docs.json	Visible en la barra lateral	URL directa	En el sitemap
Página normal	—	listada	Sí	Sí	Sí
Oculta mediante frontmatter	`hidden: true`	listada	No	Sí	No
Página fuera de la navegación (huérfana)	—	omitida	No	Sí	No
Grupo oculto	—	`hidden: true` en el grupo	No	Sí	No
Grupo oculto y buscable	—	`hidden: true, searchable: true`	No	Sí	Sí
Fuera de la búsqueda solamente	`search: false`	listada	Sí	Sí	Sí
El proyecto opta por indexar todo	—	cualquiera	Igual que arriba	Sí	Sí

Cuándo usar cada opción

Borradores y previews: frontmatter hidden: true en páginas individuales
Secciones internas para un equipo pequeño: un grupo o pestaña oculto
Documentación de cumplimiento que debe ser pública pero no promocionada: grupo oculto con searchable: true
Indexación de todo el repositorio solo para el grounding de IA: seo.indexing: "all"
Páginas reemplazadas que aún quieres que sean enlazables e indexables, pero sin que aparezcan en la búsqueda o la IA: frontmatter search: false

Las páginas ocultas no son un control de acceso. Cualquiera que tenga la URL puede leerlas. Para un control de acceso real, consulta Protección con contraseña.