Los botones son componentes interactivos diseñados para la navegación y llamadas a la acción explícitas. Admiten enrutamiento SPA interno, enlaces externos, anulaciones de color personalizadas e iconos de Lucide.
Referencia de sintaxis
::: button "Texto de la etiqueta" URL_destino [propiedad:valor...]
| Parámetro | Tipo | Descripción |
|---|---|---|
| Ruta | /ruta/ |
URL relativa del proyecto. Se resuelve automáticamente a través del enrutador SPA. |
| Externa | external:URL |
Abre la URL de destino en una nueva pestaña del navegador (target="_blank"). |
| Color | color:VALOR |
Aplica un color de fondo (admite nombres CSS estándar o códigos hexadecimales). |
| Icono | icon:NOMBRE |
Agrega un icono de Lucide antes del texto de la etiqueta. |
Ejemplos de uso
Navegación SPA interna
Utilice rutas relativas de Markdown para garantizar transiciones fluidas dentro del enrutador de una sola página:
::: button "Guía de instalación" ../../getting-started/installation.md
Guía de instalaciónEnlaces a recursos externos
Anteponga external: a la URL para forzar que los enlaces se abran en una nueva pestaña del navegador:
::: button "Ver monorepositorio en GitHub" external:https://github.com/docmd-io/docmd
Ver monorepositorio en GitHubMarca e iconografía personalizadas
Adapte los botones a la identidad de su marca utilizando anulaciones de color y nombres de iconos de Lucide:
::: button "Acción exitosa" ./#success color:#228B22 icon:check
::: button "Acción peligrosa" ./#delete color:crimson icon:alert-circle
::: button "Ver código fuente" external:https://github.com/docmd-io/docmd icon:github
Acción exitosa
Acción peligrosa
Ver código fuenteComportamiento de análisis de autocierre
Los botones son componentes de una sola línea y autocerrados. Agregar una línea final ::: inmediatamente después de un botón finaliza el contenedor primario (por ejemplo, una tarjeta o pestaña envolvente), lo que interrumpirá su diseño.
Secuencia incorrecta:
::: card "Configuración"
::: button "Iniciar configuración" ../../setup.md
::: <-- Error: Esto cierra la tarjeta prematuramente.
:::
Secuencia correcta:
::: card "Configuración"
::: button "Iniciar configuración" ../../setup.md
::: <-- Correcto: Esto cierra la tarjeta limpiamente.