Optimización SEO

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

Qué Hace Jamdesk Automáticamente

Optimizando Tu Contenido

Escribe un Frontmatter Efectivo

---
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 truncamientos 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 120-160 caracteres
• Resume lo que el lector aprenderá
• Incluye palabras clave relevantes de forma natural

Controlando la Indexación

Configuración para Todo el Sitio

En tu docs.json, configura el comportamiento predeterminado de 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 progreso
• Documentación interna
• Contenido obsoleto que conservas como referencia

URLs Canónicas

Si tu documentación es accesible desde múltiples URLs, establece una canónica:

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

Personalización de Open Graph

Anula la imagen social autogenerada:

---
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 tienen frontmatter noindex o hidden)
• Fechas de última modificación del frontmatter cuando están disponibles
• Frecuencia de cambio semanal

Excluir páginas del sitemap

Agrega noindex al frontmatter para excluir una página del sitemap y 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: nombre, URL y descripción de tu sitio (de docs.json).
• BreadcrumbList: ruta de navegación desde 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 por parte de los motores de búsqueda. Esto notifica a Bing, Yandex y otros motores de búsqueda participantes sobre los cambios en tu contenido sin esperar su próximo ciclo de rastreo.

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

Mejores Prácticas

Artículos Relacionados