Jamdesk Documentation logo

Registro de cambios

Novedades en Jamdesk, la plataforma docs-as-code para MDX, GitHub y documentación de API. Lanzamientos de funciones, actualizaciones de CLI y cambios en la plataforma.

Nuevas funciones, cambios en la plataforma y actualizaciones de CLI para Jamdesk.

Las capturas de pantalla muestran la interfaz en inglés.

Exportación a PDF. Renderiza todo tu sitio de documentación en 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 email con un enlace de descarga cuando finalice el renderizado. Consulta Exportación PDF.

Especificaciones OpenAPI multilingüe. Las páginas de endpoints ahora renderizan especificaciones OpenAPI traducidas junto con MDX traducido. Coloca un archivo <spec>.<lang>.<ext> (p. ej., openapi/api.fr.yaml) junto a tu especificación fuente y Jamdesk lo detecta en las URL de ese idioma, usando la especificación en inglés como alternativa cuando falta una variante de idioma. Los resúmenes de operaciones, descripciones de parámetros, descripciones de respuestas y descripciones de esquemas se localizan. Consulta Traducir 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 URL canónicas obtienen automáticamente la vista para agentes. Consulta Visibility.

Protección con contraseña, rediseñada. Ahora puedes bloquear todo tu sitio con una contraseña compartida, o proteger solo algunas páginas mientras el resto permanece público. Establece auth.password.enabled: true para el modo de sitio completo, 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 la marca de tu sitio, tu logo, color principal y una pista opcional que defines en docs.json. Consulta 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 en tiempo de build. Los archivos convertidos suelen ser un 60-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 con images.convertToWebp: true en docs.json. Los favicons, og:image e twitter:image permanecen en su formato original para compatibilidad con rastreadores de redes sociales. Un nuevo paso Optimizando imágenes muestra el progreso en tiempo real en el dashboard y la CLI durante cada build. Consulta Conversión automática de imágenes.

API Playground. Las páginas de endpoints ahora tienen un botón interactivo "Pruébalo". Rellena los parámetros, observa cómo se actualizan los ejemplos de código en tiempo real y envía solicitudes en vivo sin salir de tu documentación. Activado por defecto en todas las páginas de API. Compatible con endpoints OpenAPI y MDX. Consulta API Playground.

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 de CLI. Instalación en dos pasos desde el marketplace de plugins. Funciona junto con CLAUDE.md y el servidor MCP para la escritura de documentación asistida por IA.

Advertencias de build para 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 de build del dashboard y en la CLI mediante jamdesk dev y jamdesk validate. Sin email; la advertencia es solo informativa.

YouTube Shorts. El componente <YouTube> ahora admite Shorts verticales mediante la prop short, renderizando un reproductor centrado de 9:16 sin barras negras. Usa <YouTube id="VIDEO_ID" short />. Consulta Incrustaciones de YouTube.

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. Activado por defecto; elige qué opciones se muestran mediante contextual en docs.json. Consulta Menú de acciones de IA.

Analítica. Seguimiento de analíticas de página sin cookies que registra visitas, fuentes de tráfico y tendencias de visitantes con desglose por página. No se necesita banner de consentimiento. Consulta Descripción general de analítica.

Integraciones. Google Analytics 4, Google Tag Manager, Plausible Analytics y notificaciones de build de Slack (Pro).

Feed RSS para registros de cambios. Las páginas con rss: true en el frontmatter ahora generan automáticamente un feed RSS al que suscribirse. Aparece un icono 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 correctas en el feed. Consulta Componente Update.

Login y despliegue con CLI. jamdesk login se autentica mediante el navegador, jamdesk deploy empaqueta tu proyecto y activa un build desde la terminal. No se requiere conexión con GitHub. La CLI respeta .gitignore, advierte sobre archivos secretos y muestra el progreso del build en línea. Consulta Autenticación y CLI Deploy.

Corrección ortográfica con CLI. jamdesk spellcheck comprueba la ortografía de tu documentación con más de 180 términos técnicos integrados (solo en inglés). jamdesk spellcheck --fix lanza un modo interactivo para corregir erratas o añadir palabras a tu lista de ignorados. Consulta Descripción general de CLI.

Incrustaciones de vídeo. 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=moa8o29o" title="Demo" />) o el componente <Video> para autoplay, bucle y otros controles. Consulta Vídeos.

JavaScript personalizado. Añade scripts del lado del cliente para widgets de chat, analítica o integraciones de terceros mediante styling.js en docs.json. Consulta JavaScript personalizado.

Chat de IA. Asistente de chat integrado en cada sitio de documentación. Los visitantes hacen preguntas y obtienen respuestas con enlaces de citas a las páginas fuente. Impulsado por Claude, disponible en todos los planes. Consulta Chat de IA.

Integración de IA. Cada sitio genera llms.txt para ventanas de contexto de 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. Consulta también Escribir 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. Consulta Descripción general de CLI.

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. Consulta Extensión de VS Code.

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 configuración regional. Los lectores cambian de idioma desde un menú desplegable en la barra superior. Consulta Soporte multilingüe.

Analítica de búsqueda. Consulta qué buscan los lectores, qué consultas no devuelven resultados y en qué hacen clic. Útil para detectar lagunas de contenido. Consulta Analítica de búsqueda.

Lanzamiento de Jamdesk. Escribe documentación en MDX, haz push a GitHub y 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 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. Consulta Descripción general de componentes.

Documentación OpenAPI. Genera páginas de referencia de API desde tu especificación OpenAPI mediante api.openapi en docs.json. Consulta Ejemplo OpenAPI.

Despliegue. Despliegue automático desde GitHub en push con un debounce de 10s. Dominios personalizados con SSL automático, hosting en subpath en /docs (Vercel, CloudFront, Cloudflare, nginx) y soporte de monorepo.

Personalización. Tres temas (jam, nebula, pulsar) con colores personalizados, logos y pie de página. CSS personalizado para anulaciones de estilo. 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 cuenta, facturación y solución de problemas.


Mantente actualizado

Blog de Jamdesk

Anuncios detallados y tutoriales

GitHub Releases

Notas de versión de la CLI