Páginas ocultas

Algunas páginas no pertenecen a 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 por URL directa, pero desaparecen de la navegación, la búsqueda, el sitemap y el contexto AI que se proporciona a los LLMs.

Ocultar una sola página

Añade hidden: true al frontmatter de la página:

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

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

La elimina de la barra lateral
Añade <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 la búsqueda en el sitio

Ocultar un grupo o pestaña completos

Establece "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 la regla. El mismo indicador funciona en tabs, groups, anchors, dropdowns, products, languages y versions.

Mantener páginas ocultas en la búsqueda

Si quieres que una pestaña o grupo oculto no aparezca en la barra lateral pero siga siendo indexado para la búsqueda en el sitio, las respuestas AI y el sitemap, añade "searchable": true:

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

El hidden: true del frontmatter en una página hija sigue teniendo prioridad — searchable solo reactiva los descendientes que no lo han desactivado ellos mismos.

Controles a nivel de proyecto

Ambos indicadores se encuentran bajo seo en docs.json:

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

Ejemplo:

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

Referencia rápida

Escenario	Frontmatter	docs.json	Visible en barra lateral	URL directa	En sitemap
Página normal	—	listada	Sí	Sí	Sí
Oculta mediante frontmatter	`hidden: true`	listada	No	Sí	No
Página no incluida en nav (huérfana)	—	omitida	No	Sí	No
Grupo oculto	—	`hidden: true` en grupo	No	Sí	No
Grupo oculto + buscable	—	`hidden: true, searchable: true`	No	Sí	Sí
Proyecto indexa 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 ocultos
Documentos de cumplimiento que deben ser públicos pero no promocionados — grupo oculto con searchable: true
Indexación completa del repositorio solo para contexto AI — seo.indexing: "all"

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