Skip to main content
Improvements

Mejoras en la integración con GitLab

  • Se mejoró la interfaz de conexión a GitLab en la configuración del panel para facilitar la gestión de repositorios
  • Se añadió compatibilidad con webhooks para actualizar automáticamente la documentación al hacer commits en GitLab

Mejoras en el Editor web y la autenticación

  • Avances en la migración del app router para el Editor web, eliminando bloqueos y mejorando el rendimiento
  • Mejor manejo de errores de inicio de sesión con mensajes explícitos de validación de correo electrónico
  • Corrección del manejo de espacios en blanco en la validación de direcciones de correo

Correcciones de errores y confiabilidad

  • Se corrigió la actualización de sockets del app router para funciones en tiempo real
  • Se corrigieron problemas de renderizado de rutas SVG en la documentación
  • Se corrigió la navegación por teclado en la búsqueda y el chat
  • Se mejoró la confiabilidad del endpoint de estado del historial
  • Se resolvieron casos límite de middleware y problemas con el manejo del evento onClick
New releasesImprovements

Lanzamientos importantes

Asistente y MCP

  • Se corrigió un error por el cual al Asistente se le aplicaba rate limiting de forma incorrecta debido a que la ventana de tiempo no se deslizaba bien
  • Se corrigió un error en las llamadas a herramientas del Asistente para manejar correctamente bloques text vacíos
  • Se corrigió un error donde los nombres de servidor de MCP concatenados con llamadas a herramientas a veces excedían los 60 caracteres que imponen los clientes MCP
  • Se corrigió un error donde el menú del Asistente tenía una altura varias veces mayor que el viewport y hacía scroll infinito
  • Se corrigió un error donde los valores de gasto del Asistente podían mostrarse con más de dos decimales en el panel

Editor web y despliegues

  • Mejora de seguridad en el editor: solo los usuarios con write permissions en el repositorio de Git conectado pueden realizar cambios
  • Se corrigió un error donde los despliegues de vista previa no funcionaban para ramas con = en el nombre
  • Se corrigió un error donde los nombres de ramas largos se desbordaban en los modales al crear despliegues de vista previa
  • Mejora de usabilidad: el parámetro de consulta de correo electrónico rellenará previamente el campo en invitaciones de registro
  • Se corrigió un error donde copiar una página desde el menú contextual no funcionaba en Safari

Área de pruebas de API y navegación

SEO y UI

  • Se corrigió un error por el cual los favicons no aparecían en los motores de búsqueda al servirlos desde la misma URL que el sitio de documentación de cada sitio
  • Se corrigió un error donde los embeds de YouTube parpadeaban al cargar
  • Se corrigió un error donde expandir el menú de feedback para incluir respuestas escritas causaba cambios de diseño en la tabla de contenidos
  • Se corrigió un error donde el texto se superponía a la barra superior en el tema Maple al descartar la barra de notificación
  • Se mejoraron los temas Maple y Willow añadiendo botones de iniciar/cerrar sesión en la barra lateral para facilitar el acceso

Analíticas y exportaciones

  • Se corrigieron problemas de confiabilidad en la vista de analíticas del Asistente y en las exportaciones
  • Las exportaciones de analíticas del Asistente ahora se ejecutan en segundo plano y se envían por correo electrónico para una experiencia más confiable
Improvements

Lanzamiento principal: recopilación de feedback mejorada

  • Mejora importante: Ahora los lectores pueden dar feedback más detallado después de seleccionar pulgar arriba/abajo, incluyendo opciones y comentarios escritos. También puedes recopilar feedback en bloques de código y ver todas las respuestas en las analíticas de tu panel.
    Nota: Contáctanos para habilitar esta función en tu sitio.

Mejoras de navegación y de usabilidad

  • Mejora de usabilidad para ignorar las barras finales y dobles, para que no tengas que preocuparte por colocarlas exactamente bien en tu docs.json
  • Ahora puedes agregar el atributo noAnchor a tus etiquetas HTML h1-6 para evitar que tengan un enlace de ancla
  • El tema Palm ahora tiene un selector de idioma flotante en la esquina inferior izquierda, similar al enfoque de Stripe
  • Se agregó un nuevo campo a docs.json llamado drilldown que te permite controlar si los usuarios son dirigidos o no a la primera página de un grupo de navegación cuando el grupo se expande
  • Mejora de usabilidad para que las listas ordenadas anidadas alternen estilos de decimal/romano a alfabético

Correcciones de errores y confiabilidad

  • Se corrigió un error por el que los enlaces de ancla de posición de desplazamiento no funcionaban correctamente cuando había componentes JS en una página
  • Se corrigió un error por el que Google estaba indexando archivos *.md en bruto porque les faltaba el encabezado x-robots-tag: noindex
  • Se corrigió un error con OAuth en documentos protegidos por el que no te redirigía a tu página inicial tras completar correctamente el flujo
  • Se corrigió un error en las vistas previas de documentos protegidos por autenticación por el que no podías ver toda la barra de navegación
  • Correcciones en cómo se manejan los SVG con nuestra nueva CDN de imágenes

Mejoras de componentes y estilos

  • Se añadió un nuevo selector CSS para estilos personalizados en SidebarNavGroupDivider
  • Nuevas pruebas de regresión para páginas de API definidas en MDX que tienen seguridad definida garantizarán un mayor grado de estabilidad

Mejoras de rendimiento

  • Mejora de rendimiento al mover el CSS de KaTeX de cdnjs a nuestra propia CDN en CloudFront para reducir la latencia
Improvements

Mejoras en el manejo de imágenes

  • Mejora importante: Las imágenes ya no causan cambios de diseño por defecto, incluso cuando no se especifican los atributos de ancho y alto; el dimensionamiento automático evita saltos de contenido durante la carga de páginas
  • Todos los archivos estáticos en tu repositorio (PDF, TXT, XML, etc.) ahora se suben y sirven automáticamente al desplegar, proporcionando cobertura completa de recursos

Mejoras del editor web y del despliegue

  • Se corrigió el flujo de creación de ramas en el editor web para navegar correctamente a las nuevas ramas y permanecer en ellas
  • Diálogo de resolución de conflictos de fusión mejorado con funcionalidad de escape adecuada; ya no se requieren recargas de página para descartarlos
  • Flujo de actualización optimizado al invalidar la caché solo de las páginas modificadas durante actualizaciones parciales, reduciendo los tiempos de despliegue

Mejoras de autenticación y navegación

  • Nuevo soporte para autenticación en subdirectorios personalizados; si sirves la documentación en https://yourdomain.com/docs, la autenticación ahora funciona sin problemas
  • Se corrigió un error de visualización en la barra lateral que aparecía incorrectamente cuando solo se configuraba un enlace
  • Renovación integral de la navegación móvil: botones centrados con margen/espaciado adecuados, mejor espaciado en menús desplegables, eliminación de divisores y márgenes innecesarios para secciones vacías, y corrección de problemas de huecos/relleno en el tema Maple

Correcciones de componentes y estilos

  • Se resolvió el problema de conversión de etiquetas <h1-6> que las transformaba incorrectamente en componentes Heading y alteraba los estilos personalizados
  • Se añadió un interruptor de configuración de un clic para el Asistente en el panel para una gestión más sencilla

Mejoras técnicas y confiabilidad

  • Sistema de registro mejorado para flujos de actualización que permite una depuración y resolución de problemas más rápidas
  • Se corrigió la limitación de tasa de GitHub para clientes con más de 10 especificaciones de OpenAPI/AsyncAPI pasando de la obtención de archivos individuales al clonado del repositorio
  • Mayor confiabilidad del Asistente con soporte de LLM de respaldo, mejor manejo de errores por límite de tasa y una herramienta de búsqueda más robusta
Improvements

Optimizaciones de rendimiento y compilación

  • La transpilación de MDX ahora ocurre en el momento del despliegue en lugar de en cada carga de página en entornos serverless de Next.js sin caché, mejorando el time to first byte para páginas no cacheadas.
  • El hashing basado en contenido evita la retranspilación cuando MDX no ha cambiado, reduciendo los tiempos del flujo de actualización en ~50% para clientes con muchas páginas (los despliegues de más de 5 minutos deberían reducirse aproximadamente a la mitad)
  • Ver las vistas previas de despliegue en el panel ahora es más rápido gracias a índices de base de datos y paralelización de consultas en nuestro backend
  • Se redujo el tamaño de página eliminando datos duplicados de navigation en la carga rsc de cada página; las mejoras de rendimiento son más notorias con muchos documentos o estructuras de navegación complejas
  • Un prefetching más agresivo habilita cargas instantáneas de página con mayor frecuencia

Mejoras del área de pruebas de API y OpenAPI

  • La conversión de OpenAPI a MCP se movió al backend, lo que permite que los servidores MCP alojados incluyan herramientas (pronto habrá documentación y opciones de configuración más claras)
  • Se añadió compatibilidad con Ruby en el área de pruebas de API
  • Agregamos una función para que ahora puedas especificar páginas de API usando solo tu docs.json sin crear nuevos archivos MDX.
  • Compatibilidad con páginas de webhook en la navegación de la documentación a partir de especificaciones OpenAPI
  • Contexto del modelo de IA optimizado al eliminar especificaciones de enlaces de ancla de los enlaces de Markdown al navegar a Anthropic, OpenAI u otros proveedores

Mejoras del editor web

  • La creación y el cambio de nombre de archivos ahora guardan los cambios al hacer clic fuera, en lugar de requerir presionar Enter
  • Se corrigió la navegación de ramas en la que cambiar la URL a una rama específica redirigía a la última rama activa en lugar del destino previsto
  • Codificación adecuada en la URL de títulos de ramas que contienen / para evitar errores de navegación
  • Se corrigió el atajo Ctrl+K para enlaces en el Editor del panel de monorepo, que estaba anteponiendo la ruta del repositorio de docs y creando enlaces rotos

Analítica e integraciones con LLM

  • Compatibilidad con llms.txt y llms-full.txt personalizados: añádelos a la raíz del repositorio de docs para servirlos en los endpoints /llms.txt y /llms-full.txt para personalización de LLM
  • Se añadió la integración de analítica de Hightouch
  • Seguimiento de analítica del menú contextual mejorado (visualización en el panel próximamente)
  • Se agregaron pruebas de extremo a extremo para llms.txt y llms-full.txt para garantizar su correcta entrega

Mejoras de componentes y estilos

  • Compatibilidad con nombres de clase personalizados en etiquetas h{1-4} para aplicar estilos de encabezado personalizados
  • Se corrigió el renderizado de etiquetas h{1-4} como componentes Heading con chips en modo de página personalizada
  • Se añadieron selectores CSS a las breadcrumbs para objetivos de CSS personalizados
  • Se corrigieron imágenes de open graph estiradas analizando dimensiones para mantener proporciones a 56 px de altura
  • Se corrigió VSCode a VS Code en el menú contextual cuando está habilitado
  • Se corrigió que los encabezados dentro de componentes personalizados aparecieran en la tabla de contenido junto con encabezados semánticos

Correcciones de errores y confiabilidad

  • Se corrigieron problemas de renderizado de PDF con ciertos títulos de página sanitizando caracteres que causaban problemas de generación
  • Se resolvió el error de la CLI Cannot convert undefined or null to object al encontrar archivos JSON de OpenAPI vacíos
  • Se corrigió que las metatags de open graph personalizadas en docs.json fueran sobrescritas por las generadas
  • Se corrigieron los clics del botón de RSS al aterrizar en enlaces de ancla usando origin + pathname para los enlaces de RSS
  • Se mejoró la velocidad de descarga de la CLI al eliminar sourcemaps

Mejoras técnicas

  • Se añadieron pruebas visuales al pipeline de CI para detección temprana de regresiones
  • Capacidades mejoradas de manejo de errores y depuración
  • Cobertura de pruebas integral para nuevas funciones y casos límite
Improvements

Mejoras de autenticación

  • Acceso público a nivel de grupo: haz públicos grupos completos de páginas mediante docs.json para no tener que usar public: true en cada página (más información)
  • Compatibilidad con logoutURL en la configuración de OAuth para eliminar cookies ascendentes y completar el cierre de sesión
  • En errores de OAuth, los usuarios se redirigen a la logoutURL especificada para reiniciar el flujo de autenticación
  • Corregido un parpadeo de error 500 durante los flujos de OAuth/JWT antes del callback
  • Eliminación automática de https:// de las URL en la configuración de autenticación OAuth/JWT para evitar errores de configuración

Mejoras del Área de pruebas de API

  • Nuevo endpoint de la Search API para que puedas crear agentes y servidores MCP sobre tu documentación
  • Los archivos openapi y asyncapi ahora se sirven en sus rutas especificadas (por ejemplo, https://mydocsurl.extension/{openapi-or-file-name}.json)
  • Ahora puedes usar el campo x-mint en tus archivos OpenAPI para anular campos generados, personalizar el contenido de introducción o cambiar las URL de endpoints en ejemplos de código
  • x-mcp ahora es x-mint.mcp en configuraciones de OpenAPI para controlar qué rutas se exponen como herramientas MCP

Actualizaciones del Asistente

  • Se corrigió un problema en el que el menú de acciones (con opciones como copiar y pulgar arriba) de mensajes antiguos desaparecía cuando llegaban nuevos mensajes en streaming
  • Se corrigió la accesibilidad de páginas anidadas /mcp/... tras el lanzamiento de servidores MCP alojados de la semana pasada

Rendimiento y confiabilidad

  • Todos los recursos de imagen y video presentes en tu repo de docs ahora se sirven en la ruta adecuada en tu dominio. Por ejemplo, si tienes /assets/marketing/my-logo.png en tu repo, estará disponible en https://mydocsurl.extension/assets/marketing/my-logo.png.
  • El campo de correo electrónico en el inicio de sesión del panel de Mintlify ahora enfoca automáticamente para que puedas empezar a escribir de inmediato (mejora de calidad de vida)
  • Tanto dominios personalizados como subdominios en Redis para mejorar el rendimiento en los tiempos de carga de la navegación (~50 ms menos de latencia)
  • Se agregó lógica de reintentos para exportaciones a PDF y mejorar la confiabilidad
  • Se corrigió que el aviso de consentimiento de cookies reapareciera después de aceptar o descartar—ahora se respeta la primera selección
  • Se corrigió copiar una página al portapapeles en Safari especificando un type MIME en navigator.write

Mejoras técnicas

  • Correcciones de la CLI para Windows y pnpm, además de pruebas de CI para prevenir regresiones
  • Salida de registro de errores mejorada—una mejora de calidad de vida para nuestro equipo de ingeniería al depurar
  • Correcciones menores a la acción de CI de enlaces rotos cuando faltan archivos de contentDirectory
  • Se corrigió una regresión causada por las correcciones de la vista previa protegida por autenticación de la semana pasada, donde la pestaña activa no se establecía correctamente en la UI de navegación
  • Se corrigió que el color de fondo claro del tema no se aplicara a los íconos de la pestaña activa
  • Se corrigió un problema en el que cambiar el tipo de autenticación en el panel se actualizaba y luego volvía al tipo guardado anteriormente—ahora la nueva selección persiste después de guardar
  • Mejoras internas de DX para clientes empresariales con bibliotecas de UI personalizadas—ahora nos resulta más fácil incluir tus componentes y atender solicitudes en plazos más cortos
Improvements

Mejoras de autenticación

  • Mejoras en el desarrollo local de autenticación, lo que permite desarrollar más rápido funciones de autenticación y corregir errores en esta área del producto
  • Implementaciones de vista previa ahora disponibles para sitios protegidos por autenticación
  • Se corrigió el comportamiento de redirección para devolver correctamente a los usuarios a su página original después de autenticarse
  • Se corrigió la visualización del botón de cerrar sesión para autenticación completa (antes solo funcionaba con autenticación parcial)

Mejoras del área de pruebas de API

  • Se corrigió la carga de archivos multipart/form-data en el área de pruebas de API
  • Se corrigió el comportamiento de los enlaces de anclaje para que, al hacer clic, actualicen la URL sin desplazarse a la parte superior de la página
  • Se corrigieron problemas de enlaces de anclaje en pestañas anidadas

Actualizaciones del Asistente

  • Nueva API del Asistente para integrarlo en tus propios productos, compatible con AI SDK
  • Se agregó un botón de copiar a las respuestas del chat
  • Se corrigió un problema al reintentar mensajes en el Asistente
  • Mejoras en el prompt predeterminado del Asistente para que sea menos verboso por defecto

Rendimiento y confiabilidad

  • La búsqueda se siente más ágil y precisa al abortar solicitudes con debounce mientras escribes
  • Aprovisionamiento de recursos para una nueva CDN: se espera que pronto mejoren los tiempos de carga de imágenes y de páginas
  • Se corrigieron errores al renderizar diagramas Mermaid complejos como gráficos de Gantt
  • Se corrigieron errores de la CLI en Windows para mejorar la estabilidad y se agregaron pruebas para prevenir regresiones

Mejoras técnicas

  • Se agregó OpenTelemetry para trazas en la aplicación Next.js, mejorando el tiempo hasta el primer byte para los clientes
  • Migramos de Octokit a GitHub API Client para reducir la latencia en la experiencia del editor web
  • Se corrigieron etiquetas meta duplicadas para Open Graph
  • Se actualizó MongoDB de la versión 6 a la 7 para mejorar el rendimiento y añadir nuevas funciones
New releasesImprovements

Aplicación de Slack

  • Acceso sin fricción: el bot responde a DMs, @menciones y cualquier pregunta en tu canal #ask-ai
  • Configuración con un clic: instálala directamente desde tu panel de Mintlify en segundos
  • Respuestas contextuales: busca en toda tu documentación para ofrecer respuestas relevantes y precisas
  • Reduce interrupciones de soporte: convierte preguntas diarias en respuestas instantáneas de autoservicio
Más información en nuestra guía de la aplicación de Slack.

Servidores MCP alojados

Implementa servidores alojados de Model Context Protocol (MCP) directamente a través de Mintlify para integrarte con herramientas de IA como Claude, Cursor y otras. Más información en nuestra guía de MCP.Ayuda a los usuarios a conectar rápidamente tu servidor MCP con Cursor o VS Code desde cualquier página de tu documentación mediante el menú contextual. Consulta Menú contextual para más información.

Mejoras en bloques de código

  • Mejor resaltado de sintaxis
  • Se agregaron más opciones de personalización, incluyendo modo enfoque, bloques de código expandibles, adaptación a modo oscuro y claro, menú desplegable de lenguaje, numeración de líneas e iconos
New releasesImprovements

Actualizaciones del asistente de IA

  • Mayor precisión mediante RAG agentivo con llamadas a herramientas
  • Proporciona enlaces navegables a las páginas de referencia para que los usuarios puedan ir directamente a la fuente de las respuestas
  • Atajo para copiar ejemplos de código generados por el asistente
  • Atajo “Ask AI” en los bloques de código de la documentación para generar explicaciones del Asistente
Más información en la documentación del asistente.

Registros de cambios suscribibles

  • Genera automáticamente un feed RSS a partir de las páginas del registro de cambios
  • Integra actualizaciones habilitadas con RSS con Slack, correo electrónico y otras herramientas
Más información en nuestra nueva guía de registro de cambios
Improvements

Actualizaciones de estabilidad del área de pruebas de API

  • Búsqueda para encontrar un endpoint
  • Indica un endpoint obsoleto con una etiqueta
  • Oculta páginas de API autogeneradas de la navegación
  • Carga archivos multipart o de formulario
Más información en la documentación del área de pruebas de API

mint update

Ahora puedes usar mint update para actualizar tu CLI.
New releasesImprovements

Editor web 3.0

Webeditor3 Jpe
Se renovó por completo la usabilidad del editor WYSIWYG.Mejoras importantes
  • Busca nombres de archivos con el atajo ⌘ + P
  • Las páginas cargan 10 veces más rápido
  • Cargas más rápidas al buscar una rama
  • Pestaña de opciones de página para configurar el diseño, el título y los metadatos para SEO
  • Barra de herramientas flotante al resaltar texto
Correcciones adicionales
  • Corregido el margen superior en los componentes del registro de cambios
  • Mayor fiabilidad del clic derecho
  • Tras publicar, permanecerás en la misma página en lugar de pasar a un estado vacío
  • Colores estandarizados en los iconos de archivo
  • Mayor fiabilidad tras seleccionar nuevas ramas varias veces seguidas
  • Se eliminó el modo Diff
  • Más consistencia al crear una carpeta nueva desde el menú desplegable
  • Corregido: las citas en bloque creaban más citas en bloque al intentar deseleccionar

Traducciones con IA en beta

AI Translations graphic
Traduce toda tu documentación con IA. Más información.

Exportar docs a PDF en beta

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

Compatibilidad con hooks de React

Añade interactividad a tu documentación. Todos los hooks estándar de React están disponibles automáticamente en tus archivos MDX. Más información.
New releasesImprovements

Generador de servidores MCP

screenshot of MCP server generator
Genera servidores MCP para que las aplicaciones de IA puedan interactuar con tu documentación o APIs. El contenido escrito se genera automáticamente como un servidor MCP, y puedes generar un servidor MCP desde tu especificación OpenAPI con un solo clic. Consulta la documentación para comenzar con MCP.

Mejoras

  • Etiqueta las actualizaciones del registro de cambios para que los usuarios finales puedan filtrarlas
  • Sonnet-3.7 compatible para el chat de IA. Configura tu modelo preferido desde el panel
  • Cambia el nombre de tu implementación directamente en la configuración del panel

Correcciones de errores

  • Imágenes OG corregidas
  • Corregida la inconsistencia de estilo de iconos para anclas sin contenedor
  • Ajustes de estilo mejorados en el borde del panel para la adaptabilidad móvil-tableta-escritorio
  • Mostrar ejemplos de código incluso en modo simple en el área de pruebas de API
  • Compatibilidad con el atajo “command + k” para buscar en el editor web
  • Los bloques de código dentro de los avisos se expanden para ocupar todo el ancho del área del aviso
New releasesImprovements

Nuevo esquema de configuración docs.json

captura de pantalla de docs.json
Hemos introducido un nuevo esquema docs.json como reemplazo de mint.json, para admitir un mejor versionado multinivel, facilitar la comprensión visual y usar una terminología más consistente. Para ver qué cambió, consulta nuestro blog.Actualiza de mint.json a docs.json con los siguientes pasos:
  1. Asegúrate de tener la última versión de la CLI
  1. En tu repositorio de documentación, ejecuta
  1. Elimina el archivo mint.json antiguo y sube tus cambios

Verificaciones de CI

Ejecuta lint automáticamente en tu documentación para encontrar enlaces rotos, detectar errores ortográficos y gramaticales, o aplicar estilos de escritura con tu propia configuración de Vale. Obtén más información en nuestra documentación.

Compatibilidad .md para LLM

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

Más temas

gráfico con texto "Themes v2"
Nuevos temas prediseñados para modificar el look & feel de tu documentación. Configúralos a través de tu archivo docs.json.Ahora disponibles:
  • Maple
  • Palm
  • Willow

Otras mejoras

  • Guía de redacción técnica: Buenas prácticas para escribir documentación técnica, incluyendo investigación de audiencia, tipos de contenido y consejos de escritura.
  • Componente Dropdown: Organiza la navegación con un menú desplegable, además de pestañas y anclas.
  • Corrector de sintaxis con IA: El Editor web detectará si hay un error de parseo y usará IA para sugerir correcciones.
Improvements

Mejoras del Asistente de IA

  • Nueva interfaz con página de chat dedicada y prompts precargados
  • Mejoras de estabilidad. Por ejemplo, correcciones de errores al editar el archivo equivocado o ninguno
  • Conocimiento más sólido para agregar y editar componentes
  • Edición mejorada del archivo docs.json

Autenticación parcial

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

Área de pruebas de API renovada

Hemos rediseñado el Área de pruebas de API y mejorado su rendimiento. Las actualizaciones incluyen:
  • Expansión de detalles más fácil para obtener una vista general de un campo
  • Diseño anidado más intuitivo. Por ejemplo, agregar o eliminar elementos
  • Tiempos de respuesta más rápidos

Mejoras de calidad

  • Posibilidad de requerir autenticación para acceder a despliegues de vista previa

Autenticación

captura de pantalla de Autenticación
Haz que la documentación sea privada configurando autenticación vía JWT, OAuth o una contraseña universal. Con esta privacidad, puedes crear una base de conocimiento interna o evitar que los competidores vean tu documentación.

Redactor con IA

Asistente de IA
Ahora puedes pedirle a la IA que haga cambios en tu documentación, con el contexto de toda la documentación existente. Escribe una indicación y el redactor propondrá cambios creando una pull request.

Mejora de la integración con GitLab

Hemos mejorado la compatibilidad de sincronización con GitLab, habilitando, por ejemplo, actualizaciones automatizadas y despliegues de vista previa. Consulta nuestra documentación sobre GitLab para comenzar.

Editor web

Editor web
Hemos renovado nuestro editor web para que ahora puedas actualizar la documentación con una experiencia WYSIWYG completa, mientras se sincroniza con Markdown.Consulta nuestra documentación para empezar con el Editor web.

Compatibilidad con /llms.txt

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

Localización

Ahora puedes localizar tu documentación, de forma similar al versionado. Añade un locale a una versión y el contenido fijo de Mintlify, como “Was this page helpful?”, también coincidirá con ese locale.

Mejoras de calidad

  • Devolver resultados de chat y búsqueda según la versión que el usuario esté leyendo
  • Autenticar a los usuarios con OAuth, además de JWT o tokens de sesión compartida.

Registro de cambios

Lanzamos un nuevo Componente de actualización para facilitar la visualización y comunicación de actualizaciones (como esta) a tus usuarios.
Registro de cambios

Resaltado de líneas de código

Ahora puedes resaltar líneas de código en tu documentación para enfatizar y llamar la atención sobre partes importantes agregando 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

Bloques de código en modo claro

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

Pie de página avanzado

Pie de página avanzado
Ahora puedes agregar más enlaces al pie de página estándar. Esta mejora ofrece más coherencia entre las landing pages y la documentación, o mayor personalización si quieres destacar páginas específicas como redes sociales o páginas de estado.

Filtrar la búsqueda según el usuario actual

Cuando la Personalización está habilitada, los resultados de búsqueda ahora se filtran según el usuario que haya iniciado sesión, para que solo vea el contenido relevante.

Prompts personalizados para el chat de IA

Ahora puedes personalizar los prompts del chat de IA. Comunícate con support si deseas personalizar los prompts.

Mejoras en el panel

  • Se añadió la posibilidad de cambiar el dominio personalizado a /docs directamente desde la configuración del panel.
  • Se unificaron las páginas de inicio de sesión y registro para reducir la fricción y la confusión.
  • Se implementó el flujo de inicio de sesión con descubrimiento para que los usuarios que son miembros de varias organizaciones puedan cambiar entre ellas.
  • Se añadió inicio de sesión con Google OAuth.
  • Se añadió la posibilidad de agregar un nuevo deployment desde la configuración del panel.

Correcciones de errores

  • Ya se pueden usar barras iniciales en la navegación.
  • Ya se pueden editar archivos CSS y JS en el Editor web.
  • Se corrigió que suggestEdit no apareciera incluso cuando estaba habilitado.
  • Se corrigió la navegación por teclado para Búsqueda y Chat, de modo que ahora puedes usar las flechas arriba y abajo para desplazarte por los resultados.
  • No permitir que los motores de búsqueda rastreen páginas protegidas por autenticación de usuario.
  • Revalidar la caché cuando se elimina una organización.
  • Ahora usamos el parser de OpenAPI de Scalar para analizar definiciones de OpenAPI, lo que mejora el rendimiento, corrige problemas de parsing y ofrece 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 de OpenAPI.
  • Añadido soporte de estilo inline para iconos.
  • Se corrigió el “pop-in” del CSS personalizado en la documentación.
  • Mostrar correctamente el estilo de código en línea junto con enlaces.
  • Mantener la posición de desplazamiento al hacer clic en el botón Atrás del navegador.

Fuentes personalizadas

Fuentes personalizadas
Personaliza la tipografía de tu documentación usando tu propia fuente alojada en un CDN o eligiendo entre Google Fonts para alinear tu documentación con tu marca.

Imágenes en componentes Card

Agrega la propiedad img a una tarjeta para mostrar una imagen en la parte superior. Obtén más información aquí.

Mejoras en la velocidad de actualización

Mejoras de rendimiento
Para proyectos grandes (~3,000 archivos), el paso de descarga de las actualizaciones de la documentación ahora es ~440x más rápido: una reducción del 99.8% del tiempo. En general, las descargas de archivos durante las actualizaciones ahora son ~5.5x más rápidas: una reducción del 81.8% del tiempo.

Mejoras de SEO

Mejoras de SEO
Hemos corregido el diseño móvil y de escritorio de nuestra documentación para que sea más compatible con SEO, incluido añadir etiquetas aria adecuadas a la barra de navegación y a los elementos de alternancia.

Mejoras en el panel

  • Migración a App Router en el panel.
  • Las analíticas de búsqueda ahora están disponibles en el panel.
  • Se agregó la funcionalidad para eliminar una organización en el panel.
  • Se lanzó la interfaz de conexión con GitLab.
  • Corrección de datos de analíticas incorrectos.
  • Los complementos ahora se pueden comprar directamente desde el panel.

Correcciones de errores

  • Se corrigió un error donde la barra superior no se ajustaba 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, por lo que enumeramos problemas comunes para ayudarte a resolverlos rápidamente — Lee la documentación

Páginas de referencia de OpenAPI

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

Carga de archivos en el Área de pruebas de API

De forma predeterminada, las solicitudes del Área de pruebas de API se enrutan a través de Mintlify. Ahora puedes usar disableProxy para desactivar este comportamiento y admitir tipos de solicitud como la carga de archivos.

Mejoras de SEO en móviles

Hemos corregido el diseño móvil de nuestra documentación para que sea más compatible con SEO, incluido añadir etiquetas aria adecuadas a los elementos.

Formulario de soporte

Agregamos un formulario de soporte más detallado al panel de Mintlify. Ahora puedes enviar un formulario para ponerte en contacto con nosotros.

Correcciones de errores

  • Se corrigió un error en la funcionalidad de la integración con Segment.
  • Ahora mostramos mensajes de error más granulares para 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.

Widget de IA

Widget de IA
Para usuarios Pro, presentamos Mintlify Widget, una extensión de tu documentación para responder a las preguntas de tus usuarios cuando y donde las hagan. Puedes agregar este chatbot con IA a cualquier página web: tu página de inicio, dentro de tu producto o en tus páginas de documentación existentes.

Plan Pro

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

Sincronización de ejemplos de código del Área de pruebas de API

Cuando navegas por la documentación de API, el ejemplo de código seleccionado ahora se sincroniza entre tus páginas.

Insights

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

Lo más destacado de la Launch Week

  • Temas: personaliza el estilo con temas preconfigurados. Solo agrega el tema Quill, Prism o Venus a tu archivo docs.json y se actualizará el diseño de tu documentación.
  • Search V2: consulta directamente las descripciones y los títulos de los endpoints de OpenAPI para ir a las páginas de Referencia de API, elimina las páginas ocultas de la búsqueda y disfruta de nuestra barra de búsqueda renovada.
  • Ramificación en el Editor web: crea ramas en nuestro Editor web sin usar un IDE.
  • Personalización de usuarios: autentica a los usuarios con Shared Session o JWT para mostrarles contenido personalizado, como el prerellenado de claves de API o contenido específico para clientes.
  • Mejoras de automatización de OpenAPI: para autopoblar las páginas del Área de pruebas de API, puedes agregar un campo openapi a un objeto en los arreglos tabs o anchors en el docs.json.

Okta SSO

Ahora admitimos inicio de sesión mediante Okta SAML y OIDC.

Mintlify REST API

Activa actualizaciones de tu documentación de forma programática.

Modo personalizado

Agrega una configuración a los metadatos para eliminar todos los elementos excepto la barra superior. Casos de uso de ejemplo:
  • Crea una página de inicio global personalizada con componentes a medida
  • Agrega videos a pantalla completa o galerías de imágenes
  • Inserta elementos de demostración iFrame personalizados para agregar interactividad a tu documentación
Consulta nuestra documentación de Custom Mode.

Mintlify MDX para VSCode

Inserta fragmentos de nuestros componentes y avisos prediseñados sin salir de VSCode. Instala la extensión aquí.

Mejoras de calidad

  • Mejoras del panel: visualiza registros de actualización para ver qué cambió y el estado de una actualización; alterna entre proyectos de Mintlify para gestionar implementaciones
  • Versionado con pestañas totalmente compatible
  • Redirecciones con comodines ahora compatibles
  • Detección de errores en la CLI: ahora mostramos la posición del frontmatter no válido cuando hay problemas de análisis durante el desarrollo local

Lo más destacado de la Launch Week

  • Implementaciones de vista previa: cuando creas una pull request, generaremos un enlace único que muestra una vista previa en vivo de cómo se ve tu documentación en producción. Puedes compartir este enlace con tu equipo.
  • Fragmentos V2: ahora admitimos componentes y variables completamente reutilizables para los fragmentos.
  • Motor MDX de código abierto: hemos expuesto dos API—getCompiledMdx y MDXComponent—para que puedas acceder al Markdown de Mintlify y al resaltado de sintaxis de código. Se aceptan contribuciones al proyecto.
  • Insights de AI Chat: segmenta el historial de chat por fecha, aumenta la cuota de AI Chat desde el panel y ve con qué frecuencia aparece una consulta específica.