Novedades de Jamdesk, la plataforma docs-as-code para MDX, GitHub y API: lanzamientos de funciones, actualizaciones del CLI y cambios de plataforma.
Get Jamdesk release notes
New features and platform changes, straight to your inbox.
getPage acepta la url de la búsqueda. La herramienta MCP getPage acepta un parámetro url además de slug. Pasa la url que devolvió un resultado de searchDocs, una URL de página completa o un enlace .md de llms.txt. Los agentes ya no tienen que convertir los resultados de búsqueda en slugs. Servidor MCP →
Entérate cuando un push no generó un build. Un push de alguien que no es miembro de tu proyecto no genera un build. El build fallido ahora indica quién hizo el push y cómo solucionarlo, y el propietario del proyecto recibe un correo con un enlace para invitarlo, como máximo una vez por semana por persona. GitHub →
Cambia el nombre del botón Ask AI y ponle tu propio icono. Agrega chat.label y chat.icon a docs.json. La etiqueta reemplaza "Ask AI" en el botón del chat, el encabezado del panel y el atajo de búsqueda. El icono puede ser un nombre de Font Awesome, una URL de imagen o una imagen de tu proyecto. Chat de IA →
Centra o alinea a la derecha las pestañas superiores. Define tabsAlignment como "center" o "end" cuando tus pestañas estén en el encabezado. El valor predeterminado, "start", las deja a la izquierda. Navegación →
Abre un diagrama de Mermaid a pantalla completa. Haz clic en un diagrama, o enfócalo y pulsa Enter, para verlo más grande. Escape lo cierra. Agrega noZoom al componente <Mermaid> para desactivarlo en ese diagrama. Los colores que defines con style y classDef ahora se mantienen iguales en modo claro y oscuro. Mermaid →
API de búsqueda y MCP en sitios protegidos con inicio de sesión. La API de búsqueda ahora funciona en sitios con autenticación por contraseña o JWT sin agregar /_api/search a tus rutas públicas, porque comprueba tu clave de API en lugar de un inicio de sesión. El servidor MCP acepta la misma clave de API del proyecto como Authorization: Bearer <key>. Sin ella, devuelve un 401 que explica qué enviar, en lugar de redirigir a tu página de inicio de sesión. Servidor MCP →
Páginas completas y enlaces Markdown para herramientas de IA en sitios protegidos con inicio de sesión. getPage de MCP devuelve la página entera en Markdown, y tu clave de API del proyecto abre las URL .md, llms.txt y llms-full.txt. Envía la clave como Authorization: Bearer <key>; las solicitudes con clave comparten 120 por minuto. Las páginas HTML y el chat de IA siguen requiriendo un inicio de sesión. llms.txt →
El JavaScript personalizado se ejecuta en jamdesk dev. Tu script.js ahora se ejecuta en la vista previa local igual que en tu sitio publicado, así que puedes probarlo antes de hacer push. Actualiza la CLI a la versión 1.1.222 o posterior para tenerlo. JavaScript personalizado →
Elige el formato del título de tus páginas. Agrega seo.titleTemplate a docs.json para cambiar el título que se muestra en la pestaña del navegador y en los resultados de búsqueda. Cada %s se reemplaza por el título de la página: "%s | Acme" da Primeros pasos | Acme, y "%s" solo omite el nombre del sitio. Los títulos de las vistas previas de enlaces siguen mostrando solo el título de la página. SEO →
Encuentra el texto que no se verá en tu logo SVG. La tarjeta social no puede dibujar el texto dentro de un logo SVG. Cuando el logo SVG que usa la tarjeta contiene texto, tu compilación ahora muestra una sugerencia para convertir el texto en contornos (trazados). Aparece en la lista de sugerencias del panel, en jamdesk validate y en jamdesk dev. Los logos indicados con una URL completa no se revisan. SEO →
Un quinto tema: Dusk. Configura "theme": "dusk" en docs.json para un aspecto tranquilo y plano: cuerpo en Inter, encabezados en IBM Plex Serif, un acento azul tinta y una única superficie teñida separada por bordes de 1px en lugar de tarjetas elevadas. Los colores personalizados, las fuentes y las anulaciones de CSS funcionan igual que en Jam, Nebula, Pulsar y Halo. Temas →
Personaliza tus tarjetas sociales. Agrega seo.socialCard a docs.json para cambiar la tarjeta que Jamdesk genera para cada página. Puedes colorear la barra y la insignia de sección con tu colors.primary, cambiar a una tarjeta oscura, ocultar la barra o el nombre del sitio, o mostrar tu propio og:image como tarjeta completa, sin texto encima. Las tarjetas se mantienen igual hasta que agregues estos ajustes. SEO →
Ejemplos de CSS y JavaScript personalizados. Una nueva guía da estilo al encabezado con tu logo y tus colores y añade un botón flotante Ask AI, con capturas en modo claro, modo oscuro y móvil. Necesita un style.css, un script.js y unas líneas de docs.json. Los selectores son puntos de enganche estables y no nombres de clase, así que tus cambios siguen funcionando cuando Jamdesk se actualiza. Ejemplos de CSS y JS →
Un llms-full.txt por idioma. Los sitios multilingües ahora publican un archivo con todo el contenido para cada idioma, junto a su índice, como /fr/llms-full.txt para el francés y /en/llms-full.txt para tu idioma predeterminado. El índice de tu idioma predeterminado responde tanto en /en/llms.txt como en /llms.txt, de modo que todos los idiomas siguen el mismo patrón de URL. Un agente puede cargar solo el idioma que necesita en lugar de todas las páginas en todos los idiomas. El archivo raíz /llms-full.txt sigue conteniendo todos los idiomas, así que las herramientas que ya lo leen no ven ningún cambio. Los sitios de un solo idioma no cambian. llms.txt →
Envía a tus lectores directamente a su propio idioma. Configura "localization": { "autoRedirect": true } en docs.json y un visitante de primera vez cuyo navegador pida francés llega a /fr en lugar de tu idioma predeterminado. Su elección se mantiene durante un año, y elegir un idioma en el selector la anula. Solo la raíz de tu sitio se redirige alguna vez: una URL de idioma como /fr y un enlace profundo como /guides/authentication se abren exactamente como se pidieron, para todos, así que un enlace que pegues en un ticket abre la misma página para quien lo abra. Los rastreadores tampoco se redirigen nunca, así que tus etiquetas hreflang siguen decidiendo qué se indexa. Desactivado por defecto; requiere dos o más idiomas configurados. Enrutamiento automático de idiomas →
Sobrescribe la fecha de «última actualización» de una página. El metadata.timestamp de docs.json ya muestra una línea «Última actualización el …» basada en el último commit de Git de la página. Agrega lastUpdatedDate: "2026-09-01" al frontmatter de una página y esa fecha reemplaza la fecha del commit en el pie de página. También alimenta el <lastmod> de tu sitemap y el dateModified de los datos estructurados de la página, esté o no activado el pie de página, para que los buscadores y los asistentes de IA vean la misma fecha que tus lectores. Útil después de revisar una página, o cuando un commit de formato movió la fecha sin cambiar nada que un lector notaría. Frontmatter →
Desactiva el botón de copiar en un bloque de código. Agrega nocopy a la línea de apertura del bloque de código y ese bloque pierde su botón de copiar mientras que todos los demás lo conservan; se combina con un título y con el resto de las opciones de bloque, y funciona por pestaña dentro de un <CodeGroup>. Úsalo para transcripciones de terminal, ejemplos censurados y fragmentos de «no hagas esto» — en cualquier lugar donde copiar el texto renderizado le daría al lector algo que no funciona. Bloques de código →
Permite que tus lectores inicien sesión con tu propio sistema de acceso. La autenticación JWT protege un sitio de documentación detrás del sistema de acceso que ya usas, para que nadie tenga que escribir una contraseña compartida. Activa auth.jwt en docs.json, genera una clave de firma Ed25519 en Settings, y haz que tu backend firme un token de corta duración cuando un usuario abre la documentación. Jamdesk lo verifica e inicia una sesión por usuario que dura hasta 30 días. Agrega groups: ["admin"] a una página y solo los visitantes cuyo token lleve ese grupo podrán abrirla o verla en la barra lateral; todos los demás reciben un 404. Las rutas públicas, el public: true del frontmatter y los grupos de navegación públicos mantienen abiertos un registro de cambios o una página de estado. También puedes precargar el playground de la API con las credenciales del propio visitante extraídas del token. Incluido en todos los planes, y puedes migrar desde la protección por contraseña sin ninguna interrupción de cobertura. Autenticación JWT →
La raíz del sitio también exporta Markdown. Solicita la raíz de tu documentación, o una raíz de idioma como /fr, con Accept: text/markdown o como /index.md, y obtienes la primera página de esa navegación, la misma página que muestra la raíz HTML. Los sitios sin index.mdx antes devolvían un 404 aquí, lo que rompía la primera solicitud que hacen la mayoría de los agentes. Fuente Markdown →
Jamdesk traduce tu documentación a 27 idiomas. Marca los idiomas que quieras, hasta cinco por proyecto, en Settings → Translations, y después de cada build se hace commit de las páginas traducidas en tu repositorio de GitHub. Los builds posteriores solo vuelven a traducir las páginas cuya fuente en inglés cambió. Las traducciones que ya tenías, o que editaste a mano, se conservan hasta que hagas clic en Replace with AI translation. Incluido en todos los planes. Traducción por IA →
Elige tu propia URL de documentación. El alojamiento en subruta ya no está atado a /docs. Ingresa un solo segmento, como help o guide, en el campo de subruta de la tarjeta Custom Domain y guarda. /docs sigue funcionando, las URL canónicas pasan de inmediato a la nueva ruta, y la subruta personalizada anterior redirige a la nueva durante un único cambio de nombre, así que puedes actualizar tu proxy a tu propio ritmo. Alojamiento en subruta →
Fix with AI, ahora más rápido. Abrir el preview de correcciones desde el banner del build termina antes, incluso en sitios grandes, y volver a abrirlo es casi instantáneo porque Jamdesk conserva los resultados del análisis mientras tu documentación no cambie. El flujo sigue igual: revisa cada cambio propuesto, aplica los que apruebes, y Jamdesk hace commit de ellos y vuelve a generar el build. Fix with AI →
Un cuarto tema: Halo. Configura "theme": "halo" en docs.json para un aspecto cálido y redondeado: tipografía Figtree, un fondo arena con el contenido elevado sobre una tarjeta, y los radios de esquina más grandes de todos los temas integrados. Los colores personalizados, las fuentes y las anulaciones de CSS funcionan igual que en Jam, Nebula y Pulsar. Temas →
Sirve tu documentación solo desde tu propio dominio. Activa Custom domain only en la tarjeta Custom Domain y una visita directa a YOUR_SLUG.jamdesk.app devuelve un 404, mientras que tu CNAME o tu proxy siguen funcionando. Jamdesk verifica tu dominio activo antes de activar el interruptor, y si tu DNS falla, el subdominio vuelve a responder hasta que se recupera. Esto oculta el subdominio a los visitantes directos, pero no controla quién puede leer tu documentación; combínalo con la protección por contraseña para eso. Solo dominio personalizado →
Genera toda tu referencia de API a partir de una especificación. Apunta una pestaña de navegación a tu archivo OpenAPI con "openapi": { "source": "/openapi/api.yaml", "generate": true } y cada build crea una página por operación, agrupadas en la barra lateral por tag. Una página de endpoint ya commiteada conserva su slug, así que puedes migrar una página a la vez, y una ruta renombrada redirige desde su URL anterior en lugar de devolver un 404. Páginas de API generadas →
Los lectores eligen qué servidor de API están viendo. Un endpoint cuya especificación lista más de una entrada servers muestra un selector junto a su URL. Elegir sandbox cambia la URL base, el botón de copiar, cada ejemplo de código y la solicitud que envía el playground, para que nadie copie un curl de producción desde tu documentación de sandbox. Los endpoints con un solo servidor no cambian. Playground de la API →
El Markdown se renderiza en todas las descripciones de OpenAPI. Las tablas, las listas, los enlaces, el code y la negrita se renderizan ahora igual en las descripciones de parámetro, cuerpo de solicitud, respuesta y esquema que ya lo hacían en la descripción de la operación. Antes nueve lugares no coincidían entre sí, y ahora todos comparten el mismo motor de renderizado. Ejemplo de OpenAPI →
Las exportaciones en Markdown de los endpoints incluyen autenticación. Solicita la versión .md de una página de referencia de la API y termina con una sección ## Authentication que enumera los esquemas que necesita la operación: tipo, nombre de encabezado, formato de bearer, scopes de OAuth 2, y qué combinaciones son válidas. Un agente que lea la exportación puede construir una solicitud funcional sin abrir tu especificación. Fuente Markdown →
Mantén una página fuera de la búsqueda sin ocultarla. Agrega search: false al frontmatter de una página y desaparece de la búsqueda del sitio, de las respuestas del chat de IA y del servidor MCP, mientras sigue en tu barra lateral, tu sitemap y tu llms.txt. Úsalo para una página reemplazada que aún quieres poder enlazar e indexar. Las páginas ocultas y no indexadas ahora también quedan fuera de las respuestas de IA, algo que antes no pasaba. Mantener una página solo fuera de la búsqueda →
jamdesk validate avisa sobre configuración que no hace nada. Algunas claves de docs.json se aceptaban sin renderizarse nunca, sobre todo asyncapi, así que una configuración parecía compatible hasta que compilabas el sitio y no encontrabas nada. El comando las nombra, junto con las entradas api.mdx.server más allá de la primera, que siempre se han descartado. Resumen del CLI →
Edita tu documentación directamente en el dashboard. El editor web ya está disponible para todos y no requiere configuración. Abre Editor en la barra lateral para explorar tu repositorio conectado, editar MDX con preview en vivo, y hacer commit directamente en tu rama de GitHub, lo que inicia un build automáticamente. Editor web →
Corrige advertencias de build con IA, desde el dashboard. Cuando un build termina con enlaces rotos o páginas sin descripción, ahora aparece un banner Fix with AI en el build, mostrando cuántos problemas se pueden reparar. Ábrelo para ver un preview de cada cambio propuesto (anclas reescritas y descripciones de página sugeridas), y luego aplica los que apruebes. Jamdesk hace commit de ellos en tu rama de GitHub e inicia un nuevo build. Todo lo que no se pueda resolver sin ambigüedad se lista aparte para que lo corrijas a mano. Fix with AI →
Miembros de equipo ilimitados. Ahora todos los proyectos incluyen miembros de equipo ilimitados en todos los planes, sin costo adicional. El límite anterior de 10 miembros y el precio por asiento desaparecieron: invita a todo tu equipo.
Deja que bots de confianza publiquen tu documentación. Cuentas de automatización como Dependabot, Renovate o un bot de publicación de un CMS no son miembros de Jamdesk, así que sus push no activan un build por defecto. Ahora, cuando se rechaza uno, el build muestra un botón Authorize Bot Account de un clic. Apruébalo, y los push de esa cuenta se publican en tu sitio en producción, igual que los de un miembro del equipo. Solo los miembros del proyecto pueden autorizar una cuenta, y puedes revisar o revocar el acceso en cualquier momento en Allowed automation accounts, dentro de la configuración de GitHub de tu proyecto.
Tu documentación recibe una puntuación de IA en cada build. Jamdesk ahora evalúa qué tan bien pueden leer los agentes de IA tu documentación publicada — calificada según el estándar abierto AFDocs — automáticamente después de cada build, directamente en el dashboard. Consulta tu puntuación de 0 a 100 y su calificación en letra, sigue la tendencia entre builds, y obtén una solución en lenguaje sencillo para cada problema, cada una con un botón Copy prompt to fix que entrega el hallazgo a tu agente de codificación con IA. Activa Email team when score changes para enterarte cuando un build cambie tu puntuación de forma significativa. Puntuación de IA →
Corrige enlaces rotos automáticamente. Las advertencias de enlaces internos rotos con un destino sin ambigüedad — anclas mal escritas y desvíos de ancla entre idiomas — ahora se pueden corregir con un solo comando. Ejecuta jamdesk fix --dry-run para ver un preview de los cambios planeados, y luego jamdesk fix para aplicarlos; solo se modifican las advertencias cuya ancla correcta corresponde a un encabezado real, dejando los casos ambiguos para revisión manual. Resumen del CLI →
Anuncia lo que sea con un banner. Agrega un banner a tu docs.json y una barra de mensaje se fija en la parte superior de cada página — por encima del encabezado, en el color de acento de tu tema. Usa enlaces, negrita y cursiva en línea, y define dismissible: true para darles a los lectores un botón de cierre (permanece cerrada hasta que cambies el mensaje). Banner →
Muestra cuándo se actualizó cada página por última vez. Configura metadata.timestamp: true en tu docs.json y cada página obtiene en su pie de página una línea del tipo «Última actualización el 15 de junio de 2026». La fecha proviene del último commit de Git que modificó la página, así que se mantiene exacta en cada build sin mantenimiento manual de fechas. Metadatos de página →
Personaliza tus iconos de navegación. Los iconos de la barra lateral, los grupos, las pestañas, las anclas y la búsqueda ahora respetan el style de un objeto de icono ({ "name": "rocket", "style": "duotone" }) o un prefijo de estilo (duotone/rocket) — light, thin, duotone y la familia sharp, no solo solid. Iconos →
Personaliza la barra de búsqueda. Elige tu propio texto de marcador de posición con search.prompt, y organiza los enlaces rápidos que ven los visitantes en el panel de búsqueda vacío con search.popularPages — cada uno con un título, un slug de página y un icono de Font Awesome. Configuración de búsqueda →
Recopila suscripciones por correo sin necesidad de un embed. Conecta Resend, Mailchimp, Kit, Loops, beehiiv, Brevo o SendGrid en Integrations → Email Signups, y un formulario alojado por Jamdesk agrega lectores directamente a tu propia audiencia — tu clave de API se queda en nuestro backend, nunca en tu sitio publicado. Agrega el componente EmailSubscribe a cualquier página, o configura placement: changelog para poner automáticamente un cuadro de suscripción en cada página de registro de cambios. Suscripciones por correo →
Bloquea la analítica detrás del consentimiento de cookies. Agrega una clave integrations.cookies a tu docs.json y Jamdesk retiene cada script de analítica y seguimiento — Google Analytics, GTM, Plausible, Crisp, JavaScript personalizado y su propia analítica integrada — hasta que un visitante consienta, algo que se lee desde un indicador de localStorage que define tu banner de consentimiento. También puedes cargar un banner de Osano o Termly directamente desde docs.json; un breve script puente activa el indicador en cuanto un lector acepta, y los scripts se cargan sin recargar la página. Consentimiento de cookies →
llms.txt, organizado. El llms.txt de cada sitio ahora sigue la estructura de llmstxt.org — tus pestañas y grupos de navegación se convierten en secciones ##, así que los agentes de IA ven tu documentación organizada como tu barra lateral. Los sitios multilingües obtienen un índice por idioma: el archivo raíz enumera tu idioma predeterminado y enlaza a cada índice traducido (por ejemplo, /fr/llms.txt), manteniendo cada uno lo bastante pequeño para que ningún agente lo trunque. llms.txt →
Los agentes encuentran tu documentación más rápido. Cada página ahora lleva una directiva invisible y silenciosa para lectores de pantalla que señala a los agentes de IA hacia llms.txt y la versión .md de la página, y cada exportación en Markdown se abre con una cita que enlaza al índice. Los agentes que obtienen tu HTML ya no tienen que adivinar que existe una ruta en Markdown. Resumen de IA →
Incrusta tu registro de cambios donde quieras. Un lanzador «¿Qué hay de nuevo?» se agrega a tu propia aplicación con una sola etiqueta <script> y abre tu registro de cambios de Jamdesk en una ventana modal, con un punto de no leído por visitante. Genera el fragmento desde Integrations → What's New widget, y luego ajusta el modo del lanzador, la esquina, el tamaño de la modal y el color del punto con atributos data-. Dentro de tu propia documentación de Jamdesk, el componente MDX <Widget> coloca ese mismo lanzador en vivo en cualquier página con una sola etiqueta y sin script. Incrustar tu registro de cambios →
Descarga tus especificaciones de API como un zip. En cualquier página de referencia de la API, el menú AI Actions ahora tiene una opción Download API spec que empaqueta cada especificación de OpenAPI que referencia tu sitio — archivos locales y URL remotas por igual — en un único api-specs.zip. Las especificaciones de varios archivos conservan su estructura de carpetas $ref, así que la descarga se importa directamente en Postman, un generador de clientes o tu propia herramienta. AI Actions →
Las especificaciones de OpenAPI se validan al momento del build. Cada despliegue ahora valida estrictamente las especificaciones de OpenAPI que referencia tu docs.json — y muestra cualquier problema como una advertencia de build no crítica en lugar de hacer fallar el build. Tu documentación se publica de todas formas; solo se te informa exactamente qué está mal (un error de análisis de YAML con línea y columna, un $ref sin resolver, o un operationId duplicado) por correo y en la lista de builds del dashboard. En local, jamdesk dev sigue deteniéndose ante una especificación inválida para que lo detectes antes de hacer push. Resumen del CLI →
Pregúntale a la IA directamente desde la búsqueda. Empieza a escribir en la búsqueda, y luego entrega tu pregunta al chat de IA en lugar de abrir un resultado — presiona ⌘/Ctrl+Enter o haz clic en Ask AI en el pie de la búsqueda. La pregunta se agrega a tu conversación de chat para que puedas mantener un hilo, y un simple Enter sigue saltando al primer resultado. Chat de IA →
Copia respuestas y transcripciones. Cada respuesta del chat de IA tiene un botón de copiar que toma la fuente en Markdown, y una acción Copy transcript en el encabezado del chat copia toda la conversación en Markdown con el rol de cada participante — útil para pegarla en un ticket o en un documento. Chat de IA →
Desplazamiento automático del chat más inteligente. El chat solo sigue una respuesta en streaming cuando ya estás al final. Sube para releer una respuesta anterior y se queda quieto en lugar de arrastrarte de vuelta abajo; vuelve al final y se vuelve a fijar.
CSS personalizado en el preview local (CLI). jamdesk dev aplica tu CSS personalizado de la misma forma que el build publicado, para que puedas revisar el estilo antes de desplegar. Coloca cualquier archivo .css en la raíz de tu proyecto — style.css, o varios combinados en orden alfabético — y se carga al refrescar el navegador. No se necesita ninguna entrada en docs.json, igual que Mintlify incluye las hojas de estilo de la raíz. CSS personalizado →
Previews sociales personalizados desde el frontmatter. Configura cualquier etiqueta meta de Open Graph o Twitter/X directamente en el frontmatter de una página — og:title, og:description, og:image, twitter:card, keywords, y el conjunto completo de metaetiquetas. Usa claves planas de nivel superior o un bloque seo: anidado; ambas funcionan, y los valores por página anulan los valores predeterminados de tu docs.json. SEO →
Páginas ocultas. Mantén borradores, manuales internos o guías obsoletas fuera de tu barra lateral y de los resultados de búsqueda sin eliminarlos. Agrega hidden: true al frontmatter de una página, o a un grupo o pestaña en docs.json. Las páginas ocultas siguen siendo accesibles por URL directa, pero desaparecen de la navegación, el sitemap, la búsqueda del sitio y el contexto de IA — y reciben automáticamente una etiqueta noindex. ¿Necesitas un grupo oculto cuyas páginas igual se posicionen en la búsqueda? Agrega searchable: true junto a hidden. Páginas ocultas →
Decoraciones de cuadrícula y ventanas. Dos nuevos patrones de fondo se suman al degradado predeterminado del tema Jam. Configura background.decoration como "grid" para una sutil cuadrícula de puntos de 24 px, o como "windows" para dos manchas esmeriladas al estilo Windows 11 en las esquinas superiores. El degradado y el relleno plano "none" siguen funcionando como antes — elige el aspecto que combine con tu marca. Fondo →
Personalización del fondo. Un nuevo bloque background en docs.json desactiva el degradado del modo claro de Jam, redefine el color de página por modo, o ajusta el color, el tamaño, la posición y la opacidad del degradado. No se necesita CSS personalizado. Fondo →
Diagramas D2. Un segundo lenguaje de diagramas se suma a Mermaid. Etiqueta un bloque de código como d2 y Jamdesk lo renderiza como un SVG en el momento del build, con los temas claro y oscuro integrados. Mismo flujo de trabajo que Mermaid — elige el lenguaje que se ajuste al diagrama que estás dibujando. Diagramas D2 →
Resultados de búsqueda agrupados. La búsqueda ya no repite la misma página por cada coincidencia de sección. Los resultados se agrupan bajo su página principal en la ventana de búsqueda, con hasta tres secciones visibles por defecto y un elemento desplegable en línea para el resto. El resaltado de fragmentos se mantiene en su lugar — encuentras la sección correcta en menos pasadas.
Detección automática de docs.json al conectar. Conectar un repositorio de GitHub encuentra tu docs.json donde sea que esté. El flujo de conexión escanea todo el árbol y señala un mint.json de Mintlify si encuentra uno en su lugar. Los monorepos y las configuraciones anidadas funcionan sin configuración manual. Conectar GitHub →
Pistas de ubicación de docs.json en el CLI. Las configuraciones mal ubicadas son más fáciles de detectar. jamdesk validate, jamdesk dev y jamdesk doctor informan dónde está realmente tu docs.json — o dónde debería estar — en lugar de un error genérico de «no encontrado». Corrígelo en segundos en lugar de descifrar un stack trace. Resumen del CLI →
Hreflang conforme a los estándares. Las etiquetas hreflang ahora emiten códigos BCP 47 válidos. Carpetas de configuración regional como cn, jp y ja-jp se asignan a los códigos que realmente esperan los buscadores (zh, ja), con las URL del sitemap correctamente escapadas en XML. Cada página localizada se posiciona en su propia región en lugar de tratarse como contenido duplicado. Idiomas →
Exportación a PDF. Genera todo tu sitio de documentación en un solo PDF desde Settings → PDF Exports en el dashboard. Solo para planes pagos. Los proyectos multilingües eligen una configuración regional por exportación, los resultados se almacenan en caché por commit, y recibes un correo con un enlace de descarga cuando termina el renderizado.
Especificaciones de OpenAPI multilingües. Las páginas de endpoint renderizan especificaciones de OpenAPI traducidas junto con el MDX traducido. Coloca un archivo <spec>.<lang>.<ext> (por ejemplo, openapi/api.fr.yaml) junto a tu especificación de origen y Jamdesk lo detecta en las URL de ese idioma, recurriendo a la especificación en inglés cuando falta una variante de idioma. Los resúmenes de operación, las descripciones de parámetros, las descripciones de respuesta y las descripciones de esquema se localizan todos. Configuración: Traducir especificaciones de OpenAPI.
Componente Visibility. El nuevo componente <Visibility for="humans|agents"> te permite reservar contenido para lectores humanos o para agentes de IA en la misma página. Los bloques solo para humanos se renderizan en el navegador pero se eliminan de las exportaciones .md y de llms-full.txt; los bloques solo para agentes hacen lo contrario. Los agentes que solicitan Accept: text/markdown en las URL canónicas reciben automáticamente la vista para agentes.
Protección por contraseña, reconstruida. Bloquea todo tu sitio detrás de una contraseña compartida, o protege solo un puñado de páginas mientras el resto se mantiene público. Configura auth.password.enabled: true para el modo de sitio completo, o marca páginas individuales con private: true en el frontmatter (o inclúyelas bajo auth.password.private) para el modo de páginas específicas. La página Settings del dashboard te guía para establecer, rotar y revocar la contraseña. Los visitantes ven una pantalla de desbloqueo con tu marca, con el logo de tu sitio, tu color principal y una pista opcional que definas en docs.json. Guía de configuración: Protección por contraseña.
Conversión automática de imágenes a WebP. Jamdesk puede convertir tus imágenes PNG y JPG a WebP en el momento del build. Los archivos convertidos suelen ser entre un 60 y un 80 % más livianos que los originales sin pérdida visible de calidad, así que tus páginas cargan más rápido sin ningún procesamiento manual de imágenes. Actívalo mediante images.convertToWebp: true en docs.json. Los favicons, og:image y twitter:image conservan su formato original por compatibilidad con los rastreadores de redes sociales. Un nuevo paso Optimizing images muestra progreso en vivo en el dashboard y el CLI durante cada build. Conversión automática de imágenes →
Playground de la API. Las páginas de endpoint ahora tienen un botón interactivo «Try it». Completa los parámetros, observa cómo se actualizan los ejemplos de código en tiempo real, y envía solicitudes reales sin salir de tu documentación. Activado por defecto en todas las páginas de API. Funciona tanto con endpoints de OpenAPI como con los escritos en MDX.
Plugin de Claude Code. Instala el plugin de Jamdesk para Claude Code para darle a Claude un conocimiento profundo de los componentes MDX, la configuración de docs.json, los patrones de navegación y los comandos del CLI. Instalación en dos pasos desde el marketplace de plugins. Se combina con CLAUDE.md y el servidor MCP para la redacción de documentación asistida por IA.
Advertencias de build por falta de branding. Los builds ahora avisan cuando las rutas favicon o logo en docs.json referencian archivos que no existen en tu proyecto. Las advertencias aparecen en el detalle de builds del dashboard y en el CLI mediante jamdesk dev y jamdesk validate. No se envía ningún correo; la advertencia es solo informativa.
YouTube Shorts. El componente <YouTube> admite Shorts verticales mediante la prop short, renderizando un reproductor 9:16 centrado sin barras negras. Usa <YouTube id="VIDEO_ID" short />.
Menú AI Actions. Un menú desplegable en cada página permite a los lectores copiar el Markdown, abrir la página en ChatGPT/Claude/Perplexity, obtener la configuración del servidor MCP, o instalarlo con un clic en Cursor o VS Code. Activado por defecto; elige qué opciones se muestran mediante contextual en docs.json.
Analítica. Analítica de página sin cookies que rastrea vistas, fuentes de tráfico y tendencias de visitantes con desgloses por página. No se necesita ningún banner de consentimiento. Resumen: Analítica.
Integraciones. Google Analytics 4, Google Tag Manager, Plausible Analytics, y notificaciones de build en Slack (Pro).
Fuente RSS para registros de cambios. Las páginas con rss: true en el frontmatter ahora generan automáticamente una fuente RSS a la que suscribirse. Aparece un icono de RSS junto al título de la página, y un feed.xml se genera a partir de tus componentes Update en cada build. Usa la nueva prop date en Update para fechas de fuente correctas.
Inicio de sesión y despliegue por CLI. jamdesk login autentica mediante el navegador. jamdesk deploy empaqueta tu proyecto y activa un build desde la terminal. No se requiere ninguna conexión con GitHub. El CLI respeta el .gitignore, avisa sobre archivos secretos, y muestra el progreso del build en línea.
Revisión ortográfica por CLI. jamdesk spellcheck revisa tu documentación en busca de errores ortográficos con más de 180 términos técnicos integrados (solo en inglés). jamdesk spellcheck --fix inicia un modo interactivo para corregir errores tipográficos o agregar palabras a tu lista de exclusiones.
Videos incrustados. Incrusta archivos .mp4 y .webm directamente en tu documentación. Colócalos en un directorio /videos y usa la sintaxis de Markdown (<Video src="/_jd/videos/demo.mp4?v=mvayckfq" title="Demo" />) o el componente <Video> para reproducción automática, bucle y otros controles.
JavaScript personalizado. Agrega scripts del lado del cliente para widgets de chat, analítica o integraciones de terceros mediante styling.js en docs.json.
Chat de IA. Un asistente de chat integrado en cada sitio de documentación. Los visitantes hacen preguntas y obtienen respuestas con enlaces de cita hacia las páginas de origen. Impulsado por Claude, activado en todos los planes.
Integración de IA. Cada sitio genera un llms.txt para las ventanas de contexto de los LLM, expone Markdown sin procesar en URL .md, e incluye un servidor MCP en /_mcp con las herramientas searchDocs y getPage. Guías de configuración para Claude Code, Cursor y Codex. También: Escribir con IA y Actualizaciones automatizadas.
CLI. jamdesk dev para preview local con recarga en caliente, jamdesk validate para enlaces rotos, jamdesk migrate para convertir desde Mintlify/GitBook/Docusaurus, jamdesk doctor para problemas de configuración. Instálalo con npm, curl o Homebrew. Referencia completa →
Extensión de VS Code. Inicia, detén y reinicia el servidor de desarrollo desde la barra de estado de VS Code; no se necesita ninguna terminal.
Verificación TXT de dominio personalizado. Todos los dominios personalizados ahora requieren un registro TXT (_jamdesk.yourdomain.com) antes de que se active el enrutamiento. Esto evita la apropiación de dominio en subdominios no reclamados. Los dominios recién agregados verán el registro TXT en el flujo de configuración del dashboard. Consulta la guía de dominios personalizados.
Compatibilidad multilingüe. Define árboles de navegación y directorios de contenido separados por configuración regional. Los lectores cambian de idioma desde un menú desplegable en la barra superior.
Analítica de búsqueda. Qué buscan los lectores, qué consultas no devuelven nada, y qué resultados realmente reciben clics. Útil para encontrar brechas de contenido.
Jamdesk se lanza. Escribe tu documentación en MDX, súbela a GitHub, obtén un sitio en una CDN global. Los builds terminan en menos de 60 segundos.
MDX y componentes. Más de 20 componentes integrados: pestañas, acordeones, pasos, grupos de código, diagramas Mermaid, matemáticas con KaTeX e iconos. Resaltado de sintaxis con números de línea en los bloques de código. Crea componentes de React personalizados con Tailwind y hooks, y reutiliza contenido con snippets. Resumen de componentes →
Documentación de OpenAPI. Genera páginas de referencia de la API a partir de tu especificación OpenAPI mediante api.openapi en docs.json.
Despliegue. Despliegue automático desde GitHub con cada push, con un retraso de 10 s. Dominios personalizados con SSL automático, alojamiento en subruta en /docs (Vercel, CloudFront, Cloudflare, nginx), y compatibilidad con monorepos.
Personalización. Tres temas (jam, nebula, pulsar) con colores, logos y pie de página personalizados. CSS personalizado para anulaciones de estilo. Navegación flexible con pestañas, grupos e iconos. Redirecciones con coincidencia exacta y por comodín.
Búsqueda y SEO. Búsqueda de texto completo con Cmd+K, sin configuración. Sitemaps, imágenes OG y metadatos por página listos para usar.
Referencia de docs.json. Referencia de configuración completa para todos los ajustes y opciones.
Centro de ayuda. Gestión de cuenta, facturación y guías de solución de problemas.
