Optimización SEO

Optimiza tu documentación para motores de búsqueda y vistas previas sociales configurando títulos, descripciones y metadatos en el frontmatter.

Qué hace Jamdesk automáticamente

Optimizar tu contenido

Escribe un frontmatter eficaz

---
title: User Authentication    # Under 60 characters
description: Set up OAuth, JWT, and session-based authentication  # 120-160 characters
---

Títulos de página

• Mantén menos de 60 caracteres para evitar truncamiento en los resultados de búsqueda
• Incluye tu palabra clave principal cerca del inicio
• Haz que cada título sea único en toda tu documentación

Descripciones

• Apunta a entre 120 y 160 caracteres
• Resume lo que el lector aprenderá
• Incluye palabras clave relevantes de forma natural

Controlar la indexación

Configuración global del sitio

En tu docs.json, configura el comportamiento predeterminado de los robots:

{
  "seo": {
    "metatags": {
      "robots": "index, follow"
    }
  }
}

Control por página

Anula la indexación de páginas específicas en el frontmatter:

---
title: Internal Notes
noindex: true
---

Usa noindex para:

• Páginas en borrador o en curso
• Documentación interna
• Contenido obsoleto que conservas como referencia

URLs canónicas

Si tu documentación es accesible desde varias URLs, establece una canónica:

---
title: Getting Started
canonical: https://docs.example.com/getting-started
---

Personalización de Open Graph

Reemplaza la imagen social generada automáticamente:

---
title: API Reference
og:image: /images/api-social-card.png
---

Sitemap y Robots.txt

Cada sitio de Jamdesk genera sitemap.xml y robots.txt automáticamente en cada build.

Dónde encontrarlos

Las URLs dependen de si tu documentación está en un dominio raíz o bajo una subruta /docs:

https://docs.acme.com/sitemap.xml
https://docs.acme.com/robots.txt

Qué se incluye en el sitemap

• Todas las páginas publicadas (excluyendo las que tengan noindex o hidden en el frontmatter)
• Fechas de última modificación del frontmatter cuando estén disponibles
• Frecuencia de cambio semanal

Excluir páginas del sitemap

Añade noindex al frontmatter para excluir una página tanto del sitemap como de los motores de búsqueda:

---
title: Internal Notes
noindex: true
---

Las páginas con hidden: true también se excluyen automáticamente.

Datos estructurados JSON-LD

Cada página incluye automáticamente datos estructurados de schema.org como una etiqueta <script type="application/ld+json"> con dos esquemas:

• WebSite: el nombre, URL y descripción de tu sitio (de docs.json).
• BreadcrumbList: la ruta de navegación desde la página de inicio hasta la página actual, derivada de tu configuración de navigation.

No se requiere configuración. Los motores de búsqueda utilizan esto para resultados enriquecidos, como rutas de navegación en los listados de búsqueda.

IndexNow

Después de cada build, Jamdesk envía automáticamente las URLs de páginas modificadas a IndexNow para una indexación más rápida en los motores de búsqueda. Esto notifica a Bing, Yandex y otros motores participantes sobre los cambios en tu contenido sin esperar a su próximo ciclo de rastreo.

• Se activa después de cada build exitoso
• Solo envía las páginas que realmente cambiaron
• No bloquea el proceso, por lo que nunca retrasa tu build
• No requiere configuración

Buenas prácticas

Artículos relacionados