Saltar al contenido principal
Mintlify gestiona automáticamente muchas prácticas recomendadas de SEO, entre ellas:
  • Generación de metaetiquetas
  • Generación de sitemap y del archivo robots.txt
  • Estructura HTML semántica
  • Optimización móvil
Puedes personalizar por completo las metaetiquetas de tu sitio añadiendo el campo metatags a tu docs.json o al frontmatter de una página.

​
Meta tags generados automáticamente

Mintlify genera las siguientes meta tags para cada página. Puedes sobrescribir estas meta tags especificándolas en tu docs.json o en el frontmatter de una página. Metadatos básicos:
  • charset: utf-8 - Codificación de caracteres
  • og:type: website - Tipo de Open Graph
  • og:site_name - Nombre de tu sitio de documentación
  • twitter:card: summary_large_image - Tipo de tarjeta de Twitter
Metadatos específicos de la página:
  • title - Título de la página, con el formato “Título de la página - Nombre del sitio”
  • og:title - Título de Open Graph, igual que el título de la página
  • twitter:title - Título de Twitter, igual que el título de la página
  • description - Descripción de la página
  • og:description - Descripción de Open Graph, igual que la descripción de la página
  • twitter:description - Descripción de Twitter, igual que la descripción de la página
URL y canonical:
  • canonical - Se genera automáticamente a partir de la URL de la página
  • og:url - Se establece en la URL canónica
SEO e indexación:
  • robots - Generado a partir de los metadatos de la página
  • noindex - Generado a partir de los metadatos de la página
  • keywords - Generado a partir de los metadatos de la página
Imágenes:
  • og:image - Imagen de Open Graph, og:image:width establecido en 1200 y og:image:height en 630
  • twitter:image - Imagen de Twitter, twitter:image:width establecido en 1200 y twitter:image:height en 630
Metadatos del navegador y la aplicación:
  • applicationName - Nombre de tu sitio de documentación
  • generator: Mintlify - Identifica a Mintlify como el generador del sitio
  • apple-mobile-web-app-title - Nombre de la aplicación en la pantalla de inicio de iOS
  • msapplication-TileColor - Color del mosaico de Windows
  • Favicons e iconos de tu configuración
  • Enlace de referencia al mapa del sitio (sitemap)
Cualquier meta tag en tu configuración docs.json seo.metatags también se inyecta automáticamente en cada página, como google-site-verification para la validación en Google Search Console.

​
Metadatos globales

Para establecer metadatos predeterminados para todas las páginas, agrega el campo metatags a tu docs.json. 
"seo": {
    "metatags": {
        "og:image": "enlace a tu imagen de meta etiqueta por defecto"
    }
}

​
Configura una URL canónica

Si utilizas un dominio personalizado, establece la metaetiqueta canonical para asegurarte de que los motores de búsqueda indexen tu dominio preferido. Una URL canónica indica a los motores de búsqueda qué versión de tu documentación es la principal. Esto mejora el SEO (Search Engine Optimization) cuando tu documentación es accesible desde varias URL y evita problemas de contenido duplicado. 
"seo": {
    "metatags": {
        "canonical": "https://www.your-custom-domain-here.com"
    }
}

​
Metaetiquetas específicas de página

Para configurar metaetiquetas específicas de página, agrégalas al frontmatter de la página. Las metaetiquetas específicas de página incluyen:
  • title - Título de la página
  • description - La descripción de la página aparece debajo del título en la página y en algunos resultados de motores de búsqueda
  • keywords - Palabras clave separadas por comas
  • og:title - Título de Open Graph para compartir en redes sociales
  • og:description - Descripción de Open Graph
  • og:image - URL de la imagen de Open Graph
  • og:url - URL de Open Graph
  • og:type - Tipo de Open Graph como “article” o “website”
  • og:image:width - Ancho de la imagen de Open Graph
  • og:image:height - Altura de la imagen de Open Graph
  • twitter:title - Título de la tarjeta de Twitter
  • twitter:description - Descripción de la tarjeta de Twitter
  • twitter:image - Imagen de la tarjeta de Twitter
  • twitter:card - Tipo de tarjeta de Twitter como summary o summary_large_image
  • twitter:site - Cuenta del sitio en Twitter
  • twitter:image:width - Ancho de la imagen de Twitter
  • twitter:image:height - Altura de la imagen de Twitter
  • noindex - Establécelo en true para evitar que los motores de búsqueda indexen la página
  • robots - Valor de la metaetiqueta robots
---
title: "Título de tu página de ejemplo"
description: "Descripción específica de la página"
"og:image": "enlace a tu imagen de meta tag"
"og:title": "Título para redes sociales"
keywords: ["keyword1", "keyword2"]
---
Las metaetiquetas con dos puntos deben ir entre comillas. Por ejemplo, og:title: "Social media title".El campo keywords debe estar en formato de lista YAML. Por ejemplo, keywords: ["keyword1", "keyword2", "keyword3"].

​
Referencia de etiquetas meta comunes

A continuación encontrarás una lista completa de etiquetas meta que puedes añadir a tu docs.json. Estas etiquetas ayudan a mejorar el SEO de tu sitio, el rendimiento en redes sociales y la compatibilidad con navegadores.
La etiqueta og:image añade una imagen de fondo que Mintlify superpone automáticamente con tu logotipo, el título de la página y la descripción al generar las vistas previas para redes sociales.
Puedes previsualizar cómo se muestran tus etiquetas meta en diferentes plataformas usando metatags.io. 
"seo": {
    "metatags": {
      "robots": "noindex",
      "charset": "UTF-8",
      "viewport": "width=device-width, initial-scale=1.0",
      "description": "Descripción de la página",
      "keywords": "palabra_clave1, palabra_clave2, palabra_clave3",
      "author": "Nombre del Autor",
      "robots": "index, follow",
      "googlebot": "index, follow",
      "google": "notranslate",
      "google-site-verification": "verification_token",
      "generator": "Mintlify",
      "theme-color": "#000000",
      "color-scheme": "light dark",
      "canonical": "https://your-custom-domain-here.com",
      "format-detection": "telephone=no",
      "referrer": "origin",
      "refresh": "30",
      "rating": "general",
      "revisit-after": "7 days",
      "language": "en",
      "copyright": "Copyright 2024",
      "reply-to": "email@example.com",
      "distribution": "global",
      "coverage": "Mundial",
      "category": "Tecnología",
      "target": "all",
      "HandheldFriendly": "True",
      "MobileOptimized": "320",
      "apple-mobile-web-app-capable": "yes",
      "apple-mobile-web-app-status-bar-style": "black",
      "apple-mobile-web-app-title": "Título de la App",
      "application-name": "Nombre de la App",
      "msapplication-TileColor": "#000000",
      "msapplication-TileImage": "path/to/tile.png",
      "msapplication-config": "path/to/browserconfig.xml",
      "og:title": "Título de Open Graph",
      "og:type": "website",
      "og:url": "https://example.com",
      "og:image": "https://example.com/image.jpg",
      "og:description": "Descripción de Open Graph",
      "og:site_name": "Nombre del Sitio",
      "og:locale": "en_US",
      "og:video": "https://example.com/video.mp4",
      "og:audio": "https://example.com/audio.mp3",
      "twitter:card": "summary",
      "twitter:site": "@username",
      "twitter:creator": "@username",
      "twitter:title": "Título de Twitter",
      "twitter:description": "Descripción de Twitter",
      "twitter:image": "https://example.com/image.jpg",
      "twitter:image:alt": "Descripción de la Imagen",
      "twitter:player": "https://example.com/player",
      "twitter:player:width": "480",
      "twitter:player:height": "480",
      "twitter:app:name:iphone": "Nombre de la App",
      "twitter:app:id:iphone": "12345",
      "twitter:app:url:iphone": "app://",
      "article:published_time": "2024-01-01T00:00:00+00:00",
      "article:modified_time": "2024-01-02T00:00:00+00:00",
      "article:expiration_time": "2024-12-31T00:00:00+00:00",
      "article:author": "Nombre del Autor",
      "article:section": "Tecnología",
      "article:tag": "etiqueta1, etiqueta2, etiqueta3",
      "book:author": "Nombre del Autor",
      "book:isbn": "1234567890",
      "book:release_date": "2024-01-01",
      "book:tag": "etiqueta1, etiqueta2, etiqueta3",
      "profile:first_name": "John",
      "profile:last_name": "Doe",
      "profile:username": "johndoe",
      "profile:gender": "male",
      "music:duration": "205",
      "music:album": "Nombre del Álbum",
      "music:album:disc": "1",
      "music:album:track": "1",
      "music:musician": "Nombre del Artista",
      "music:song": "Nombre de la Canción",
      "music:song:disc": "1",
      "music:song:track": "1",
      "video:actor": "Nombre del Actor",
      "video:actor:role": "Nombre del Papel",
      "video:director": "Nombre del Director",
      "video:writer": "Nombre del Guionista",
      "video:duration": "120",
      "video:release_date": "2024-01-01",
      "video:tag": "etiqueta1, etiqueta2, etiqueta3",
      "video:series": "Nombre de la Serie"
  }
}

​
Sitemaps y archivos robots.txt

Mintlify genera automáticamente un archivo sitemap.xml y un archivo robots.txt. Puedes ver tu sitemap añadiendo /sitemap.xml a la URL de tu sitio de documentación. Por defecto, solo se incluyen las páginas presentes en tu docs.json. Para incluir enlaces ocultos, añade seo.indexing a tu docs.json: 
"seo": {
    "indexing": "all"
}

​
Sitemaps y archivos robots.txt personalizados

Para añadir un archivo sitemap.xml o robots.txt personalizado, crea un archivo sitemap.xml o robots.txt en la raíz de tu proyecto. Añadir un archivo personalizado sustituye al archivo generado automáticamente con el mismo nombre. Si eliminas un archivo personalizado, el archivo predeterminado se aplicará de nuevo automáticamente.

​
Desactivar la indexación

Para evitar que los motores de búsqueda indexen una página, agrega noindex: true al frontmatter de la página. 
---
noindex: true
---
Las páginas con hidden: true en su frontmatter se consideran automáticamente como noindex. Consulta Páginas ocultas para más detalles.
También puedes especificar noindex para todas las páginas de tu documentación estableciendo el campo metatags.robots en "noindex" en tu docs.json: 
"seo": {
    "metatags": {
      "robots": "noindex"
    }
  }

​
Mejores prácticas de SEO

  • Usa títulos de página claros y descriptivos (50-60 caracteres)
  • Redacta descripciones convincentes (150-160 caracteres)
  • Incluye palabras clave relevantes
  • Haz que cada título de página y cada descripción sean únicos
  • Utiliza una jerarquía de encabezados adecuada (H1 → H2 → H3)
  • Escribe para personas primero y para motores de búsqueda después
  • Incluye palabras clave relevantes en los encabezados y el contenido
  • Mantén las URL cortas, descriptivas y organizadas jerárquicamente
  • Divide el contenido extenso con subtítulos y listas
  • Enlaza a páginas relacionadas dentro de tu documentación
  • Usa texto de anclaje descriptivo en lugar de “haz clic aquí”
  • Crea clústeres de temas enlazando conceptos relacionados
  • Utiliza las funciones automáticas de referencias cruzadas
  • Usa nombres de archivo descriptivos para las imágenes
  • Incluye siempre texto alternativo por accesibilidad y SEO
  • Optimiza el tamaño de los archivos de imagen para una carga más rápida
  • Usa imágenes relevantes que respalden tu contenido