Mayo 2025

Actualizaciones de estabilidad del área de pruebas de API

  • Búsqueda para encontrar un endpoint
  • Indicar un endpoint obsoleto con una etiqueta
  • Ocultar páginas de API generadas automáticamente de la navegación
  • Subir archivos multipart o de datos de formulario

Aprende más en documentación del área de pruebas de API.

npm i mint

Ahora puedes usar npm i mint@latest -g para actualizar tu CLI.

Abril 2025

Editor Web 3.0

Usabilidad renovada en el editor WYSIWYG.

Mejoras importantes

  • Buscar nombres de archivos usando el atajo ⌘ + P
  • Las páginas cargan 10 veces más rápido
  • Tiempos de carga más rápidos al buscar una rama
  • Pestaña de opciones de página para configurar diseño, título y metadatos para SEO
  • Barra de herramientas flotante al resaltar texto

Correcciones adicionales

  • Margen superior fijo para componentes de registro de cambios
  • Mejorada la fiabilidad del comportamiento del clic derecho
  • Después de hacer clic en publicar, permanecerás en la misma página en lugar de ser llevado a un estado vacío
  • Colores estandarizados en los iconos de archivos
  • Mejorada la fiabilidad después de seleccionar nuevas ramas varias veces seguidas
  • Eliminado el modo Diff
  • Mayor consistencia al crear una nueva carpeta desde el menú desplegable
  • Corregido el problema de las citas en bloque que creaban más citas en bloque al intentar deseleccionar

Traducciones con IA en beta

Traduce toda tu documentación con IA. Aprende más.

Exportación de documentos a PDF en beta

Exporta toda tu documentación, un subdirectorio o una sola página como PDF.

Soporte para hooks de React

Añade interactividad a tus documentos. Todos los hooks estándar de React están automáticamente disponibles en tus archivos MDX. Aprende más.

Marzo 2025

Generador de servidor MCP

Genera servidores MCP para que las aplicaciones de IA puedan interactuar con tus documentos o APIs. El contenido escrito se genera automáticamente como un servidor MCP, y puedes generar un servidor MCP a partir de tu especificación OpenAPI con un solo clic. Consulta la documentación sobre cómo empezar con MCP.

Mejoras

  • Etiquetar actualizaciones del registro de cambios para que los usuarios finales puedan filtrar las actualizaciones
  • Sonnet-3.7 compatible con AI Chat. Configura tu modelo preferido a través del panel de control
  • Cambia el nombre de tu despliegue directamente en la configuración del panel de control

Correcciones de errores

  • Imágenes OG corregidas
  • Corregida la inconsistencia de estilo de los iconos para anclajes sin contenedor
  • Mejorados los detalles de estilo del borde del panel de control para la capacidad de respuesta móvil-tableta-escritorio
  • Mostrar ejemplos de código incluso en modo simple para el área de pruebas de API
  • Soporte para el atajo “command + k” para búsqueda en el editor web
  • Los bloques de código dentro de las notas se expanden para llenar el ancho del área de la nota
Febrero 2025

Nuevo esquema de configuración docs.json

Hemos introducido un nuevo docs.json esquema como reemplazo de mint.json, para admitir mejor el control de versiones multinivel, una comprensión visual más fácil y una terminología más consistente. Para obtener más información sobre lo que ha cambiado, consulta nuestro blog.

Actualiza de mint.json a docs.json con los siguientes pasos:

  1. Asegúrate de que tu CLI esté en la última versión
npm i mint@latest -g
  1. En el repositorio de tus documentos, ejecuta
mint upgrade
  1. Elimina tu antiguo archivo mint.json y sube tus cambios

Comprobaciones de CI

Revisa automáticamente tus documentos para encontrar enlaces rotos, descubrir problemas de ortografía y gramática, o aplicar estilos de escritura con tu propia configuración de Vale. Aprende más en nuestra documentación.

Soporte .md para LLMs

Todas las páginas de documentación están ahora automáticamente disponibles como archivos Markdown simples—solo añade .md a la URL. Esto facilita que los LLMs ingieran páginas individuales de tu documentación.

Más Temas

Nuevos temas preconfigurados para modificar el aspecto y la sensación de tus documentos. Configura a través de tu archivo docs.json.

Ahora disponibles:

  • Maple
  • Palm
  • Willow

Otras mejoras

Enero 2025

Mejoras del Asistente de IA

  • Nueva interfaz de usuario con página de chat dedicada y prompts preestablecidos
  • Mejoras de estabilidad, por ejemplo, correcciones de errores al editar el archivo incorrecto o ningún archivo en absoluto
  • Conocimiento más robusto para añadir y editar componentes
  • Edición mejorada del archivo mint.json

Autenticación Parcial

Personaliza el acceso a cualquier página o sección de contenido según los permisos del usuario. Compatible con la conexión a tu propio sistema de autenticación.

Área de pruebas de API renovada

Hemos renovado completamente el diseño y el rendimiento del Área de pruebas de API. Las actualizaciones incluyen:

  • Expansión más fácil de detalles para una visión general de un campo
  • Diseño anidado más intuitivo, por ejemplo, para añadir o eliminar elementos
  • Tiempos de respuesta más rápidos

Mejoras de Calidad

  • Soporte para requerir autenticación para acceder a despliegues de vista previa
Diciembre 2024

Autenticación

Haz que los documentos sean privados configurando la autenticación mediante JWT, OAuth o una contraseña universal. Con esta privacidad, puedes crear una base de conocimientos interna o evitar que los competidores vean tus documentos.

Noviembre 2024

Asistente de IA

Ahora puedes pedirle a la IA que haga cambios en tus documentos, con el contexto de toda la documentación existente. Escribe un prompt y el asistente propondrá cambios generando una solicitud de extracción.

Actualización de la Integración con GitLab

Hemos mejorado nuestro soporte para la sincronización con GitLab, como habilitar actualizaciones automatizadas y despliegues de vista previa. Consulta nuestra documentación sobre GitLab para comenzar.

Editor Web

Hemos renovado nuestro editor web para que ahora puedas actualizar los documentos con una experiencia completamente WYSIWYG, mientras se sincroniza con markdown.

Echa un vistazo a nuestros documentos sobre cómo empezar con el Editor Web.

/llms.txt support

Todas las instancias de documentos ahora se alojan automáticamente en /llms.txt y /llms-full.txt para que los LLMs puedan ingerir fácilmente tu documentación. Para más información, lee los documentos sobre el nuevo estándar llms.txt.

Localización

Ahora puedes localizar tus documentos, lo que funciona de manera similar al versionado. Añade un locale a una versión y el contenido fijo en Mintlify como “¿Fue útil esta página?” también coincidirá con el idioma.

Mejoras de Calidad

  • Devuelve resultados de chat y búsqueda basados en la versión actual que el usuario está leyendo
  • Autentica usuarios con OAuth, además de tokens JWT o de Sesión Compartida.
Octubre 2024

Registros de cambios

Lanzamos un nuevo componente Update para facilitar la visualización y el informe de actualizaciones (como esta) a tus usuarios.

Resaltado de Líneas de Código

Ahora puedes resaltar líneas de código en tus documentos para enfatizar y llamar la atención sobre partes importantes añadiendo un comentario especial después del identificador del lenguaje. Usa llaves {} y especifica números de línea o rangos separados por comas.

Line Highlighting Example
const greeting = "Hello, World!";
function sayHello() {
  console.log(greeting);
}
sayHello();
```javascript Line Highlighting Example {1,3-5}
const greeting = "Hello, World!";
function sayHello() {
  console.log(greeting);
}
sayHello();
```

Bloques de código en modo claro

Los bloques de código ahora tienen una variante en modo claro que se puede habilitar añadiendo lo siguiente a tu mint.json:

"codeBlock": {
  "mode": "auto"
}

Pie de Página Avanzado

Ahora puedes añadir más enlaces al pie de página estándar. Esta mejora proporciona más consistencia entre las páginas de inicio y los documentos, o una mayor personalización si deseas destacar páginas específicas como redes sociales o registros de estado.

Filtrar búsqueda basada en el usuario actual

Cuando la personalización está habilitada, los resultados de búsqueda ahora se filtran según el usuario actualmente conectado para que solo vean el contenido relevante.

Indicaciones Personalizadas para el Chat de IA

Ahora puedes personalizar las indicaciones para el chat de IA. Por favor, contacta con el soporte si deseas personalizar las indicaciones.

Mejoras en el Panel de Control

  • Se añadió la capacidad de cambiar el dominio personalizado a /docs directamente a través de la configuración del panel de control.
  • Se consolidaron las páginas de inicio de sesión y registro para disminuir la fricción y la confusión.
  • Se implementó el flujo de inicio de sesión de descubrimiento para que los usuarios que son miembros de múltiples organizaciones ahora puedan cambiar entre ellas.
  • Se añadió el inicio de sesión con OAuth de Google
  • Se añadió la capacidad de agregar nuevos despliegues a través de la configuración del panel de control.

Correcciones de Errores

  • Ahora se pueden usar barras diagonales iniciales en la navegación.
  • Ahora se pueden editar archivos CSS y JS en el editor web.
  • Se corrigió suggestEdit que no aparecía incluso cuando estaba habilitado.
  • Se corrigió la navegación por teclado para Búsqueda y Chat de modo que ahora puedes usar las teclas de flecha arriba y abajo para navegar por los resultados.
  • No se permite a los motores de búsqueda rastrear páginas protegidas por autenticación de usuario.
  • Se revalida la caché cuando se elimina una organización.
  • Ahora usamos el analizador Scalar OpenAPI para analizar definiciones OpenAPI, lo que mejora el rendimiento, corrige problemas de análisis y muestra mejores mensajes de error.
  • Ahora se admiten descripciones de nivel superior en las páginas de referencia de API generadas automáticamente a partir de definiciones OpenAPI.
  • Se añadió soporte de estilo en línea para iconos
  • Se corrigió la aparición repentina de CSS personalizado en los documentos.
  • Se muestra correctamente el estilo de código en línea junto con los enlaces.
  • Se mantiene la posición de desplazamiento cuando haces clic en el botón de retroceso en un navegador.
Septiembre 2024

Fuentes Personalizadas

Personaliza la fuente de tus documentos con tu propia fuente alojada en un CDN o eligiendo entre las fuentes de Google para que tus documentos coincidan con tu marca.

Imágenes en componentes de Tarjeta

Añade una propiedad img a una tarjeta para mostrar una imagen en la parte superior de la tarjeta. Aprende más sobre esto aquí.

Mejoras en la Velocidad de Actualización

Para proyectos grandes (~3,000 archivos), el paso de descarga para actualizaciones de documentos es ahora ~440 veces más rápido - una reducción del 99.8% en tiempo. En general, las descargas de archivos durante las actualizaciones son ahora ~5.5 veces más rápidas - una reducción del 81.8% en tiempo.

Mejoras de SEO

Hemos corregido tanto el diseño móvil como el de escritorio de nuestros documentos para que sean más amigables con el SEO - incluyendo la adición de etiquetas aria adecuadas a los elementos de la barra de navegación y de alternancia.

Mejoras en el Panel de Control

  • Migración del enrutador de aplicaciones en el panel de control.
  • Las analíticas de búsqueda ahora están disponibles en el panel de control.
  • Se ha añadido la funcionalidad de eliminar una organización al panel de control.
  • Se implementó la interfaz de usuario de conexión con GitLab.
  • Se corrigieron datos de analíticas incorrectos.
  • Los complementos ahora se pueden comprar directamente a través del panel de control.

Correcciones de Errores

  • Se corrigió un error donde la barra superior no se extendía al ancho de la pantalla cuando estaba en modo personalizado y el diseño de la barra lateral era sidenav.
  • Se corrigió el posicionamiento relativo del widget de IA.

Más

  • Solución de problemas para páginas de API: Las páginas de API pueden ser complicadas, así que hemos listado problemas comunes para ayudarte a resolverlos rápidamente —Lee los documentos
Agosto 2024

Páginas de Referencia OpenAPI

  • Los endpoints definidos por OpenAPI que son complejos y recursivos son ahora un 98% más pequeños.
  • Ahora mostramosadditionalPropertiesen las páginas de OpenAPI.

Carga de Archivos en el Área de Juegos de API

Por defecto, las solicitudes del área de juegos de API son proxificadas por Mintlify. Ahora puedes usardisableProxy para deshabilitar este comportamiento y admitir tipos de solicitudes como cargas de archivos.

Mejoras de SEO para móviles

Hemos corregido el diseño móvil de nuestros documentos para que sean más amigables con el SEO - incluyendo la adición de etiquetas aria adecuadas a los elementos.

Formulario de Soporte

Hemos añadido un formulario de soporte más detallado al panel de control de Mintlify. Ahora puedes enviar un formulario para ponerte en contacto con nosotros.

Correcciones de Errores

  • Se corrigió un error en la funcionalidad de integración de Segment.
  • Ahora mostramos mensajes de error más detallados para los permisos de GitHub al interactuar con el editor.
  • Se corrigieron errores donde la navegación no se expandía correctamente cuando se usaba un enlace directo.
Julio 2024

Widget de IA

Para Prousuarios, presentamos Mintlify Widget, una extensión de su documentación para responder a las preguntas de sus usuarios cuando y donde las hagan. Puede agregar este chatbot impulsado por IA a cualquier página web: su página de inicio, dentro de su producto o en sus páginas de documentación existentes.

Pro Plan

También actualizamos nuestros planes de precios para una mejor personalización y escala.

Sincronización de ejemplos de código del API Playground

Cuando navega por la documentación de la API, el ejemplo de código seleccionado ahora se sincroniza a través de sus páginas.

Insights

Actualmente en beta, esta función resume las preguntas y patrones comunes de los usuarios en informes fáciles de digerir con sugerencias impulsadas por IA sobre cómo mejorar su producto.

Junio 2024

Aspectos destacados de la Semana de Lanzamiento

  • Themes: Customize your styling with pre-configured themes. Just add the theme Quill, Prism, or Venus to your mint.json archivo y actualizará el estilo de su documentación.
  • Búsqueda V2: consulte directamente las descripciones y títulos de los endpoints de OpenAPI para llegar a las páginas de Referencia de API, elimine las páginas ocultas de la búsqueda y disfrute de nuestra interfaz de barra de búsqueda actualizada.
  • Ramificación del editor web: cree ramas en nuestro editor web sin un IDE.
  • Personalización de usuario: autentique a los usuarios con Shared Session o JWT para que pueda mostrarles contenido personalizado, como prellenar claves de API o mostrar contenido específico para los clientes.
  • Mejoras de automatización de OpenAPI: para autocompletar las páginas de API Playground, puede agregar un openapi campo a un objeto en los arrays de tabs o anchors en el mint.json.
Mayo 2024

Okta SSO

Ahora admitimos el inicio de sesión a través de Okta SAML y OIDC.

API REST de Mintlify

Active programáticamente actualizaciones en su documentación.

Abril 2024

Modo personalizado

Agregue una configuración a los metadatos para eliminar todos los elementos excepto la barra superior. Casos de uso de ejemplo:

  • Cree una configuración de página de inicio global personalizada con componentes personalizados
  • Agregue videos de pantalla completa o galerías de imágenes
  • Incruste elementos de demostración de iFrame personalizados para agregar interactividad a su documentación

Consulte nuestra documentación del Modo Personalizado.

Marzo 2024

Mintlify MDX para VSCode

Llame a fragmentos de nuestros componentes y llamadas preconfiguradas sin salir de VSCode. Instale la extensión aquí.

Febrero 2024

Mejoras de calidad

  • Mejoras en el panel de control: vea los registros de actualización para ver qué ha cambiado y el estado de una actualización, alterne entre proyectos de Mintlify para gestionar implementaciones
  • Versionado con pestañas totalmente compatible
  • Redirecciones con comodines ahora compatibles
  • Detección de errores de CLI: ahora mostramos la posición del frontmatter inválido cuando hay problemas de análisis durante el desarrollo local
Enero 2024

Aspectos destacados de la Semana de Lanzamiento

  • Implementaciones de vista previa: Cuando cree una solicitud de extracción, generaremos un enlace único que muestra una vista previa en vivo de cómo se verá su documentación en producción. Puede compartir este enlace con los miembros del equipo.
  • Snippets V2: Ahora admitimos componentes completamente reutilizables y variables para snippets.
  • Motor MDX de código abierto: Hemos expuesto dos APIs—getCompiledMdx y MDXComponent—para que pueda acceder al markdown de Mintlify y al resaltado de sintaxis de código. Las contribuciones al proyecto son bienvenidas.
  • Insights del Chat de IA: Segmente el historial de chat por fecha y aumente la cuota del Chat de IA desde el panel de control, y vea con qué frecuencia aparece una consulta específica.