Novedades en Jamdesk, la plataforma docs-as-code para MDX, GitHub y documentación de API. Lanzamientos, actualizaciones de CLI y cambios de plataforma.
Nuevas funciones, cambios de plataforma y actualizaciones de CLI para Jamdesk.
Las capturas de pantalla muestran la interfaz en inglés.
Integra tu changelog en cualquier sitio. Un lanzador «¿Qué hay de nuevo?» se añade a tu propia aplicación con una sola etiqueta <script> y abre tu changelog de Jamdesk en una ventana modal, con un punto de novedades por visitante. Genera el snippet desde Configuración → widget Novedades y luego ajusta el modo de lanzamiento, la esquina, el tamaño de la modal y el color del punto con atributos data-. Tu changelog se queda en tu documentación; el widget lo lleva a tu producto. Integra tu changelog →
Descarga tus specs OpenAPI como un zip. En cualquier página de referencia de API, el menú de Acciones IA tiene ahora una opción Descargar spec OpenAPI que agrupa cada spec OpenAPI que referencia tu sitio — tanto los archivos locales como las URLs remotas — en un único api-specs.zip. Las specs de varios archivos conservan su estructura de carpetas con $ref, así que la descarga encaja directamente en Postman, en un generador de clientes o en tus propias herramientas. Acciones IA →
Specs OpenAPI validadas en el momento del build. Cada despliegue ahora valida estrictamente las specs OpenAPI que referencia tu docs.json — y señala cualquier problema como una advertencia no bloqueante en lugar de hacer fallar el build. Tu documentación se publica igualmente; solo se te indica exactamente qué falla (un error de análisis YAML con línea y columna, un $ref sin resolver o un operationId duplicado) por correo y en la lista de builds del panel. En local, jamdesk dev sigue deteniéndose ante una spec inválida para que la detectes antes de subir los cambios. Resumen de la CLI →
Pregunta a la IA directamente desde la búsqueda. Empieza a escribir en la búsqueda y envía tu pregunta al chat de IA en lugar de abrir un resultado — pulsa ⌘/Ctrl+Intro o haz clic en Preguntar a la IA en el pie de la búsqueda. La pregunta se añade a tu conversación para mantener el hilo, e Intro a secas sigue abriendo el primer resultado. Chat IA →
Copiar respuestas y transcripciones. Cada respuesta del chat de IA tiene un botón de copia que toma el origen en Markdown, y una acción Copiar transcripción en la cabecera del chat copia toda la conversación como Markdown etiquetado por rol — útil para pegarla en una incidencia o un documento. Chat IA →
Desplazamiento automático del chat más inteligente. El chat solo sigue una respuesta en streaming cuando ya estás abajo del todo. Desplázate hacia arriba para releer una respuesta anterior y se queda donde está en vez de arrastrarte hacia abajo; vuelve al final y se vuelve a anclar.
CSS personalizado en preview local (CLI). jamdesk dev aplica tu CSS personalizado de la misma forma que lo hace el build publicado, para que puedas revisar los estilos 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 necesitas ninguna entrada en docs.json, igual que como Mintlify incluye hojas de estilo en la raíz. CSS personalizado →
Previsualizaciones sociales personalizadas desde frontmatter. Configura cualquier meta tag 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 metatags. Usa claves planas de nivel superior o un bloque seo: anidado; ambos funcionan, y los valores por página reemplazan los valores predeterminados de docs.json. SEO →
Páginas ocultas. Mantén borradores, manuales internos o guías obsoletas fuera de tu barra lateral y resultados de búsqueda sin eliminarlos. Añade 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 sigan apareciendo en la búsqueda? Añade searchable: true junto a hidden. Páginas ocultas →
Decoraciones de cuadrícula y ventanas. Dos nuevos patrones de fondo se unen al degradado predeterminado del tema Jam. Establece background.decoration en "grid" para una sutil cuadrícula de puntos de 24px, o en "windows" para dos manchas esmeriladas estilo Windows 11 en las esquinas superiores. El degradado y el relleno plano "none" siguen funcionando como antes — elige el aspecto que mejor se adapte a tu marca. Fondo →
Personalización de fondo. Un nuevo bloque background en docs.json desactiva el degradado del modo claro de Jam, anula el color de página por modo, o ajusta el color, tamaño, posición y opacidad del degradado. No se necesita CSS personalizado. Fondo →
Diagramas D2. Un segundo lenguaje de diagramas se une a Mermaid. Etiqueta un bloque de código delimitado con d2 y Jamdesk lo renderiza como un SVG en tiempo de build, con temas claro y oscuro integrados. El mismo flujo de trabajo que Mermaid — elige el lenguaje que mejor se adapte al diagrama que estás creando. 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 el modal de búsqueda, con hasta tres secciones visibles por defecto y un expansor en línea para el resto. El resaltado de fragmentos se mantiene — encuentras la sección correcta con menos búsquedas.
Detección automática de docs.json al conectar. Al conectar un repositorio de GitHub, se encuentra tu docs.json dondequiera que esté. El flujo de conexión escanea todo el árbol y señala un mint.json de Mintlify si lo encuentra. Los monorepos y configuraciones anidadas funcionan sin configuración manual. Conectar GitHub →
Indicaciones de ubicación de docs.json en la 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. Descripción general de la CLI →
hreflang conforme a estándares. Las etiquetas hreflang ahora emiten códigos BCP 47 válidos. Las carpetas de idioma como cn, jp y ja-jp se asignan a los códigos que los motores de búsqueda realmente esperan (zh, ja), con las URL del sitemap escapadas en XML. Cada página localizada se posiciona en su propia región en lugar de ser tratada como contenido duplicado. Idiomas →
Exportación a PDF. Renderiza todo tu sitio de documentación a un único PDF desde Configuración → Exportaciones PDF en el dashboard. Solo para planes de pago. Los proyectos multilingüe eligen una configuración regional por exportación, los resultados se almacenan en caché por commit, y recibirás un correo electrónico con un enlace de descarga cuando finalice el renderizado.
Especificaciones OpenAPI multilingüe. Las páginas de endpoint renderizan especificaciones OpenAPI traducidas junto con MDX traducido. Coloca un archivo <spec>.<lang>.<ext> (p. ej., openapi/api.fr.yaml) junto a tu spec de origen y Jamdesk lo utiliza en las URLs de ese idioma, recurriendo a la spec en inglés cuando falta una variante de idioma. Los resúmenes de operaciones, las descripciones de parámetros, las descripciones de respuestas y las descripciones de esquemas se localizan. Configuración: Traducción de especificaciones OpenAPI.
Componente Visibility. El nuevo componente <Visibility for="humans|agents"> te permite reservar contenido para lectores humanos o 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 URLs canónicas obtienen automáticamente la vista de agente.
Protección con contraseña, reconstruida. Protege todo tu sitio con una contraseña compartida, o restringe solo algunas páginas mientras el resto permanece público. Establece auth.password.enabled: true para el modo de todo el sitio, o marca páginas individuales con private: true en el frontmatter (o inclúyelas en auth.password.private) para el modo de páginas específicas. La página de Configuración en el dashboard te guía para establecer, rotar y revocar la contraseña. Los visitantes ven una pantalla de desbloqueo con tu logo, color principal y una pista opcional que defines en docs.json. Guía de configuración: Protección con contraseña.
Conversión automática de imágenes a WebP. Jamdesk puede convertir tus imágenes PNG y JPG a WebP durante el build. Los archivos convertidos suelen ser entre un 60 y un 80% más pequeños que los originales sin pérdida de calidad visible, por lo 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 permanecen en su formato original para compatibilidad con los rastreadores de redes sociales. Un nuevo paso de optimización de imágenes muestra el progreso en tiempo real en el dashboard y el CLI durante cada build. Conversión automática de imágenes →
API Playground. Las páginas de endpoint ahora tienen un botón interactivo "Probar". Completa los parámetros, observa cómo los ejemplos de código se actualizan en tiempo real y envía solicitudes en vivo sin salir de tu documentación. Habilitado por defecto en todas las páginas de API. Funciona tanto con OpenAPI como con endpoints creados 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 complementa con CLAUDE.md y el servidor MCP para la escritura de documentación asistida por IA.
Advertencias de build por branding faltante. Los builds ahora advierten cuando las rutas de favicon o logo en docs.json hacen referencia a archivos que no existen en tu proyecto. Las advertencias aparecen en los detalles del build del dashboard y en el CLI mediante jamdesk dev y jamdesk validate. Sin correo electrónico; 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ú de acciones de IA. Un menú desplegable en cada página permite a los lectores copiar 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. Habilitado por defecto; elige qué opciones se muestran mediante contextual en docs.json.
Analíticas. Seguimiento de analíticas de páginas sin cookies que registra visitas, fuentes de tráfico y tendencias de visitantes con desglose por página. No se necesita banner de consentimiento. Descripción general: Analíticas.
Integraciones. Google Analytics 4, Google Tag Manager, Plausible Analytics y notificaciones de build por Slack (Pro).
Feed RSS para changelogs. Las páginas con rss: true en el frontmatter ahora generan automáticamente un feed RSS al que suscribirse. Aparece un icono de RSS junto al título de la página, y se crea un feed.xml a partir de tus componentes Update durante cada build. Usa la nueva prop date en Update para fechas de feed correctas.
Login e implementación con el CLI. jamdesk login se autentica a través del navegador. jamdesk deploy empaqueta tu proyecto y activa un build desde la terminal. No se requiere conexión a GitHub. El CLI respeta .gitignore, advierte sobre archivos con secretos y muestra el progreso del build en línea.
Corrector ortográfico del CLI. jamdesk spellcheck comprueba 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 lanza un modo interactivo para corregir errores tipográficos o añadir palabras a tu lista de ignorados.
Incrustación de vídeos. Incrusta archivos .mp4 y .webm directamente en tu documentación. Colócalos en un directorio /videos y usa sintaxis Markdown (<Video src="/_jd/videos/demo.mp4?v=mpzun54z" title="Demo" />) o el componente <Video> para autoplay, bucle y otros controles.
JavaScript personalizado. Añade scripts del lado del cliente para widgets de chat, analíticas o integraciones de terceros mediante styling.js en docs.json.
Chat con IA. Asistente de chat integrado en cada sitio de documentación. Los visitantes hacen preguntas y obtienen respuestas con enlaces de cita a las páginas de origen. Impulsado por Claude, habilitado en todos los planes.
Integración con IA. Cada sitio genera llms.txt para ventanas de contexto de LLM, expone Markdown sin procesar en URLs .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: Escritura con IA y Actualizaciones automatizadas.
CLI. jamdesk dev para preview local con hot reload, jamdesk validate para enlaces rotos, jamdesk migrate para convertir desde Mintlify/GitBook/Docusaurus, jamdesk doctor para problemas de configuración. Instala mediante npm, curl o Homebrew. Referencia completa →
Extensión de VS Code. Inicia, detiene y reinicia el servidor de desarrollo desde la barra de estado de VS Code, sin necesidad de terminal.
Verificación TXT de dominio personalizado. Todos los dominios personalizados ahora requieren un registro TXT (_jamdesk.tudominio.com) antes de que se active el enrutamiento. Esto evita la apropiación de dominios en subdominios no reclamados. Los dominios recién añadidos verán el registro TXT en el flujo de configuración del dashboard. Consulta la guía de dominios personalizados.
Soporte multilingüe. Define árboles de navegación y directorios de contenido separados por idioma. Los lectores cambian de idioma desde un menú desplegable en la barra superior.
Analíticas de búsqueda. Lo que buscan los lectores, qué consultas no devuelven resultados y qué resultados se hacen clic realmente. Útil para encontrar lagunas de contenido.
Jamdesk se lanza. Escribe documentación en MDX, publícala en GitHub y obtén un sitio en un 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 KaTeX e iconos. Resaltado de sintaxis con números de línea en bloques de código. Crea componentes React personalizados con Tailwind y hooks, y reutiliza contenido con snippets. Descripción general de componentes →
Documentación de OpenAPI. Genera páginas de referencia de API desde tu spec OpenAPI mediante api.openapi en docs.json.
Despliegue. Auto-despliegue desde GitHub al hacer push con un debounce de 10s. Dominios personalizados con SSL automático, hosting en subruta en /docs (Vercel, CloudFront, Cloudflare, nginx), y soporte para monorepos.
Personalización. Tres temas (jam, nebula, pulsar) con colores personalizados, logos y pie de página. CSS personalizado para anular estilos. Navegación flexible con pestañas, grupos e iconos. Redirecciones con coincidencia exacta y con comodines.
Búsqueda y SEO. Búsqueda de texto completo con Cmd+K, sin configuración. Sitemaps, imágenes OG y meta por página incluidos de serie.
Referencia de docs.json. Referencia de configuración completa para todos los ajustes y opciones.
Centro de ayuda. Guías de gestión de cuentas, facturación y solución de problemas.
