Cada página es un archivo MDX que combina contenido Markdown con componentes de React para que puedas crear documentación rica e interactiva.
Cada página comienza con frontmatter, los metadatos YAML delimitados por --- al inicio del archivo. Estos metadatos definen cómo se ve y se comporta tu página.
Usa los metadatos para controlar:
- Títulos y descripciones de la página
- Títulos, íconos y etiquetas de la barra lateral
El título de tu página que aparece en la navegación y en las pestañas del navegador.
Una breve descripción de lo que trata esta página. Aparece debajo del título y mejora el SEO.
Un título breve que se muestra en la navegación de la barra lateral.
El ícono que se mostrará.Opciones: El estilo del ícono de Font Awesome. Solo se usa con íconos de Font Awesome.Opciones: regular, solid, light, thin, sharp-solid, duotone, brands. Una etiqueta que aparece junto al título de tu página en la barra lateral.
Ejemplo de frontmatter YAML
---
title: "Acerca del frontmatter"
description: "El frontmatter es la metadata que controla cómo se muestra y se comporta tu página"
sidebarTitle: "Frontmatter"
icon: "book"
tag: "NUEVO"
---
mode.
Si no se define ningún modo, se utiliza un diseño estándar con navegación en la barra lateral y una tabla de contenidos.
---
title: "Título de página por defecto"
---
---
title: "Título de página ancho"
mode: "wide"
---
---
title: "Título de página personalizado"
mode: "custom"
---
---
title: "Título de la página en marco"
mode: "frame"
---
---
title: "Centrar título de la página"
mode: "center"
---
api o openapi.
---
openapi: "GET /endpoint"
---
url.
---
title: "Paquete npm"
url: "https://www.npmjs.com/package/mint"
---
Optimización para motores de búsqueda
Las metaetiquetas con dos puntos deben ir entre comillas.
---
"twitter:image": "/images/social-preview.jpg"
---
Palabras clave de búsqueda interna
keywords en tus metadatos. Estas palabras clave no aparecerán como parte del contenido de la página ni en los resultados de búsqueda, pero los usuarios que las busquen verán la página como resultado.
---
keywords: ['configuración', 'puesta en marcha', 'primeros pasos']
---