Saltar al contenido principal

​
Instalación de la CLI

Requisito previo: Instala Node.js antes de continuar.
1

Instala la CLI.

Ejecuta el siguiente comando para instalar la CLI:
npm i -g mint
2

Vista previa local.

Ve a tu directorio de documentación (donde se encuentra el archivo docs.json) y ejecuta el siguiente comando:
mint dev
La vista previa local de tu documentación estará disponible en http://localhost:3000.
Como alternativa, si no quieres instalar la CLI de forma global, puedes ejecutar un script único: 
npx mint dev

​
Actualizaciones

Si la vista previa local no coincide con lo que ves en la versión de producción en la web, actualiza tu CLI local: 
mint update
Si el comando mint update no está disponible en tu versión local, reinstala la CLI a la versión más reciente: 
npm i -g mint@latest

​
Puertos personalizados

De forma predeterminada, la CLI utiliza el puerto 3000. Puedes personalizar el puerto usando la opción --port. Para ejecutar la CLI en el puerto 3333, por ejemplo, usa este comando: 
mint dev --port 3333
Si intentas ejecutar en un puerto que ya está en uso, se usará el siguiente puerto disponible: 
El puerto 3000 ya está en uso. Probando con el 3001.

​
Vista previa como un grupo específico

Si usas Autenticación parcial para restringir el acceso a tu documentación, puedes obtener una vista previa como un grupo de autenticación específico usando la opción --group [groupname]. Por ejemplo, si tienes un grupo llamado admin, puedes obtener una vista previa como miembro de ese grupo con el siguiente comando: 
mint dev --group admin

​
Comandos adicionales

Aunque mint dev es el comando más utilizado, hay otros comandos que puedes usar para administrar tu documentación. La CLI puede ayudarte a validar los enlaces de referencia de tu documentación. Para identificar enlaces rotos, usa el siguiente comando: 
mint enlaces-rotos

​
Verificar la especificación de OpenAPI

Puedes usar la CLI para revisar tu archivo de OpenAPI en busca de errores con el siguiente comando: 
mint openapi-check <archivoOpenapiOUrl>
Puedes proporcionar un nombre de archivo (por ejemplo, ./openapi.yaml) o una URL (por ejemplo, https://petstore3.swagger.io/api/v3/openapi.json).

​
Cambiar el nombre de archivos

Puedes cambiar el nombre y actualizar todas las referencias a archivos con el siguiente comando: 
mint rename <nombreArchivoAnterior> <nombreArchivoNuevo>

​
Migrar páginas de endpoints en MDX

Puedes migrar páginas de endpoints en MDX a páginas autogeneradas a partir de tu especificación de OpenAPI con el siguiente comando: 
mint migrate-mdx
Este comando convierte páginas individuales de endpoints en MDX en páginas autogeneradas definidas en tu docs.json, mueve el contenido de MDX a la extensión x-mint en tu especificación de OpenAPI y actualiza tu navegación. Consulta Migración desde MDX para obtener información detallada.

​
Formateo

Al desarrollar localmente, recomendamos usar extensiones en tu IDE para reconocer y dar formato a archivos MDX. Si usas Cursor, Windsurf o VS Code, recomendamos la extensión MDX para VS Code para el resaltado de sintaxis y Prettier para el formateo de código. Si usas JetBrains, recomendamos el plugin MDX para IntelliJ IDEA para el resaltado de sintaxis y configurar Prettier para el formateo de código.

​
Solución de problemas

Esto puede deberse a una versión desactualizada de Node. Prueba lo siguiente:
  1. Desinstala la versión actualmente instalada de la CLI de mint: npm uninstall -g mint
  2. Actualiza a Node.js.
  3. Reinstala la CLI de mint: npm install -g mint
Solución: Ve al directorio raíz de tu usuario y elimina la carpeta ~/.mintlify. Después, ejecuta mint dev de nuevo.
Esto se debe a no tener los permisos necesarios para instalar paquetes de Node de forma global.Solución: Intenta ejecutar sudo npm i -g mint. Se te pedirá tu contraseña, la misma que usas para desbloquear tu computadora.
Es probable que se deba a una versión desactualizada de la CLI.Solución: Ejecuta mint update para obtener los cambios más recientes.
Si tienes algún problema con el paquete de la CLI, primero ejecuta npm ls -g. Este comando muestra qué paquetes están instalados globalmente en tu máquina.Si no usas npm o no lo ves en la lista con -g, prueba which mint para localizar la instalación.Si tienes un paquete llamado mint y otro llamado mintlify instalado, debes desinstalar mintlify.
  1. Desinstala el paquete antiguo:
  npm uninstall -g mintlify
  1. Limpia la caché de npm:
  npm cache clean --force
  1. Reinstala el paquete nuevo:
npm i -g mint
⌘I