Saltar al contenido principal
La aplicación de escritorio está en beta y puede cambiar.
La aplicación de escritorio de Mintlify ejecuta tu dashboard y el editor en tu computadora. Trabaja en pestañas o en varias ventanas con acceso al mismo contenido y a la misma configuración que usas en el navegador. La aplicación de escritorio actualiza el contenido igual que cuando trabajas en el editor. También puedes abrir archivos Markdown de tu computadora para editarlos o copiarlos a un proyecto. Para previsualizar todo tu sitio localmente, usa la CLI.
La aplicación de escritorio abierta en la página de inicio rápido de Mintlify.La aplicación de escritorio abierta en la página de inicio rápido de Mintlify.

​
Instalar

Requiere macOS 14 o posterior en Apple silicon.
  1. Descarga la aplicación de escritorio desde mintlify.com/desktop.
  2. Abre el archivo.
  3. Arrastra Mintlify a tu carpeta Applications.
También puedes instalarla desde la terminal.
Install the desktop app
El script instala la aplicación en /Applications, o en ~/Applications si no puedes escribir en /Applications.

​
Iniciar sesión

La aplicación de escritorio inicia sesión con la cuenta de Mintlify que ya usas en tu navegador predeterminado.
  1. Abre la aplicación de escritorio. La aplicación muestra una pantalla Log in to Mintlify.
  2. Haz clic en Continue in browser. Tu navegador predeterminado abre una página de consentimiento de Mintlify que muestra tu cuenta y tu organización.
  3. Haz clic en Approve. Para iniciar sesión en otra organización, primero haz clic en Use a different organization.
  4. Vuelve a la aplicación de escritorio. La aplicación inicia tu sesión.
La aplicación de escritorio y tu navegador comparten la misma sesión. Si cierras sesión en uno, también se cierra en el otro.

​
Iniciar sesión sin el navegador

El inicio de sesión desde el navegador no está disponible para algunas organizaciones, como las que establecen una duración máxima de sesión. Si la página de consentimiento indica que el inicio de sesión de escritorio no está disponible, inicia sesión dentro de la aplicación:
  1. En la pantalla Log in to Mintlify, haz clic en Log in here instead.
  2. Inicia sesión de la misma forma en que inicias sesión en tu dashboard en el navegador.

​
Pestañas y ventanas

Abre cada página en la que estés trabajando en su propia pestaña o ventana. Las pestañas y ventanas se vuelven a abrir donde las dejaste cuando reinicias la aplicación. Haz clic derecho en una pestaña para duplicarla, copiar su enlace o cerrar las demás pestañas. Haz clic con el botón central en una pestaña para cerrarla. Para mostrar las pestañas en una barra lateral en lugar de en la parte superior de la ventana, cambia la disposición de las pestañas en Configuración.

​
Las pestañas comparten una sesión

Todas las pestañas y ventanas comparten una sesión. Cerrar sesión o cambiar de organización en una pestaña se aplica a todas las pestañas, y la aplicación recarga tus pestañas abiertas. Si inicia sesión otra persona, la aplicación borra primero los datos almacenados. Si iniciaste sesión a través de tu navegador, es posible que cambiar de organización en la aplicación de escritorio aún no sea compatible. Cuando la aplicación muestre un mensaje indicando que el cambio no es compatible, cierra sesión y luego vuelve a iniciar sesión y elige la organización que quieras. En la página de consentimiento, haz clic en Use a different organization para seleccionarla. Las pestañas solo cargan el dashboard de Mintlify y los servicios que usa para iniciar sesión, la facturación, conectar proveedores de Git y conectar Slack. Los enlaces a cualquier otro sitio se abren en tu navegador predeterminado. Los enlaces que empiezan por mintlify:// se abren en la aplicación de escritorio. Compártelos en Slack, añádelos a tu documentación o pégalos en la barra de direcciones de tu navegador. La aplicación abre la página en una nueva pestaña de tu ventana actual y la trae al frente. Para escribir un enlace mintlify://, reemplaza https://app.mintlify.com/ por mintlify:// en una URL del dashboard. Por ejemplo, este enlace abre la misma página que https://app.mintlify.com/acme/docs/editor:
La aplicación ignora los enlaces mintlify:// que saldrían del dashboard de Mintlify. Para abrir los enlaces mintlify:// en tu navegador predeterminado, desactiva Open Mintlify links in the app en Configuración.

​
Abrir páginas del dashboard desde tu navegador

Después de iniciar sesión en la aplicación de escritorio a través de tu navegador, ese navegador abre las páginas del dashboard en la aplicación de forma predeterminada. Cuando abres un enlace del dashboard desde fuera del dashboard, por ejemplo desde Slack o el correo electrónico, el navegador muestra una página Redirecting to Mintlify Desktop… y la página se abre en la aplicación de escritorio. Los enlaces que sigas dentro del dashboard permanecen en tu navegador. Si tu navegador pide permiso para abrir Mintlify, concédelo. Para omitir el aviso la próxima vez, elige permitir siempre los enlaces de Mintlify. Para abrir un solo enlace en tu navegador, haz clic en Or continue in browser en la página de redirección. Para dejar de abrir las páginas del dashboard en la aplicación, haz clic en Stop opening Mintlify Desktop automatically en la página de redirección o desactiva Always open in desktop app en tu configuración de Perfil. Ambas opciones solo se aplican al navegador actual. Las páginas del dashboard se abren así en la aplicación incluso cuando Open Mintlify links in the app está desactivado.

​
Abrir archivos locales

Abre un archivo Markdown de tu computadora para verlo y editarlo en el editor. La aplicación de escritorio abre archivos .md, .mdx, .markdown y .txt de hasta 5 MB. Para abrir un archivo, selecciona File > Open File… o presiona Cmd + O. El archivo se abre en una pestaña nueva.
  • El modo Visual muestra el archivo con componentes de Mintlify como callouts, tarjetas, pasos y bloques de código.
  • El modo Markdown muestra el código fuente. Úsalo para el contenido que el editor visual no puede mostrar.
Presiona Cmd + S o haz clic en Save para guardar los cambios en el archivo. La aplicación de escritorio mantiene el frontmatter del archivo sin cambios. Guardar desde el modo Visual puede reformatear parte del Markdown, como los marcadores de lista y el espaciado. El modo Visual no aplica el tema de tu sitio ni carga snippets ni imágenes relativas. Las pestañas de archivos locales no se vuelven a abrir cuando reinicias la aplicación. No necesitas iniciar sesión para abrir y editar archivos locales.

​
Copiar un archivo a un proyecto

Con la sesión iniciada, puedes añadir un archivo local a uno de los proyectos de tu organización como una página nueva.
  1. Haz clic en Copy to project.
  2. Selecciona un proyecto.
La aplicación de escritorio abre el proyecto en el editor en una pestaña nueva y añade el archivo como una página nueva al final de tu navegación. El título y la descripción de la página provienen del frontmatter del archivo. Publica la página como cualquier otro cambio.

​
Atajos de teclado

En Windows y Linux, usa Ctrl en lugar de Cmd. Para ver los atajos dentro del editor, consulta Atajos de teclado.

​
Configuración

Abre la configuración con Cmd + , en macOS o Ctrl + , en Windows y Linux.
  • Tab layout: Muestra las pestañas en la parte superior de la ventana (Horizontal) o en una barra lateral (Vertical).
  • Open Mintlify links in the app: Abre los enlaces mintlify:// en la aplicación. Activado de forma predeterminada. Si está desactivado, estos enlaces se abren en tu navegador predeterminado.
  • Check for updates: Comprueba si hay una nueva versión de la aplicación. Consulta Actualizaciones.
  • Clear all data: Cierra la sesión en todas las pestañas, cierra todas las pestañas y restablece la configuración. La aplicación se reinicia.
La ventana de configuración también muestra la versión de la aplicación.

​
Actualizaciones

La aplicación busca actualizaciones al iniciarse y cada cuatro horas mientras se ejecuta. Cuando hay una actualización disponible, aparece un botón Update available en la barra de pestañas. Para buscar actualizaciones manualmente, haz clic en Check for updates en Configuración. También puedes seleccionar Check for Updates… en el menú de la aplicación. En macOS, está debajo de About Mintlify en el menú Mintlify. En Windows y Linux, está al final del menú File. Un cuadro de diálogo indica si hay una actualización disponible y te permite instalarla.
  • macOS: Haz clic en Update en el diálogo, o en Update available en la barra de pestañas, para descargar la actualización. Cuando termine, haz clic en Restart to update.
  • Windows y Linux: Haz clic en Update para descargar la nueva versión desde tu navegador y luego instálala.

​
Desinstalar

  1. Cierra la aplicación de escritorio.
  2. Mueve Mintlify de tu carpeta Applications a la Papelera.
  3. Para eliminar tu inicio de sesión y tu configuración, elimina ~/Library/Application Support/Mintlify Electron.