Nouveautés de Jamdesk, la plateforme docs-as-code pour MDX, GitHub et l'API : fonctionnalités, mises à jour du CLI et évolutions de la plateforme.
Get Jamdesk release notes
New features and platform changes, straight to your inbox.
getPage accepte l'url de la recherche. L'outil MCP getPage accepte un paramètre url en plus de slug. Passez l'url renvoyée par un résultat searchDocs, une URL de page complète ou un lien .md de llms.txt. Les agents n'ont plus à reconvertir les résultats de recherche en slugs. Serveur MCP →
Sachez quand un push n'a pas lancé de build. Un push d'une personne qui n'est pas membre de votre projet ne lance pas de build. Le build échoué indique maintenant qui a poussé et comment corriger le problème, et le propriétaire du projet reçoit un e-mail avec un lien pour l'inviter, au plus une fois par semaine et par personne. GitHub →
Renommez le bouton Ask AI et donnez-lui votre propre icône. Ajoutez chat.label et chat.icon à docs.json. Le libellé remplace « Ask AI » sur le bouton du chat, dans l'en-tête du panneau et dans le raccourci de recherche. L'icône peut être un nom Font Awesome, une URL d'image ou une image de votre projet. Chat IA →
Centrez ou alignez à droite les onglets du haut. Définissez tabsAlignment sur "center" ou "end" lorsque vos onglets sont dans l'en-tête. La valeur par défaut, "start", les garde à gauche. Navigation →
Ouvrez un diagramme Mermaid en plein écran. Cliquez sur un diagramme, ou placez-y le focus et appuyez sur Entrée, pour le voir en plus grand. Échap le ferme. Ajoutez noZoom au composant <Mermaid> pour désactiver cette option sur ce diagramme. Les couleurs que vous définissez avec style et classDef restent désormais identiques en mode clair et en mode sombre. Mermaid →
API de recherche et MCP sur les sites protégés par connexion. L'API de recherche fonctionne désormais sur les sites protégés par mot de passe ou par JWT sans ajouter /_api/search à vos chemins publics, car elle vérifie votre clé API plutôt qu'une connexion. Le serveur MCP accepte la même clé API du projet sous la forme Authorization: Bearer <key>. Sans clé, il renvoie un 401 qui indique quoi envoyer, au lieu d'une redirection vers votre page de connexion. Serveur MCP →
Pages complètes et liens Markdown pour les outils IA sur les sites protégés par connexion. getPage du MCP renvoie la page entière en Markdown, et votre clé API du projet ouvre les URL .md, llms.txt et llms-full.txt. Envoyez la clé dans Authorization: Bearer <key> ; les requêtes avec clé partagent 120 requêtes par minute. Les pages HTML et le chat IA exigent toujours une connexion. llms.txt →
Le JavaScript personnalisé s'exécute dans jamdesk dev. Votre script.js s'exécute désormais dans l'aperçu local comme sur votre site publié, ce qui vous permet de le tester avant de faire un push. Mettez la CLI à jour vers la version 1.1.222 ou ultérieure pour en profiter. JavaScript personnalisé →
Choisissez le format du titre de vos pages. Ajoutez seo.titleTemplate à docs.json pour modifier le titre affiché dans l'onglet du navigateur et dans les résultats de recherche. Chaque %s est remplacé par le titre de la page : "%s | Acme" donne Premiers pas | Acme, et "%s" seul omet le nom du site. Les titres des aperçus de liens affichent toujours le titre de la page seul. SEO →
Repérez le texte qui ne s'affichera pas dans votre logo SVG. La carte sociale ne peut pas dessiner le texte d'un logo SVG. Quand le logo SVG utilisé par la carte contient du texte, votre build affiche désormais une suggestion pour convertir le texte en contours (tracés). Elle apparaît dans la liste des suggestions du tableau de bord, dans jamdesk validate et dans jamdesk dev. Les logos indiqués par une URL complète ne sont pas vérifiés. SEO →
Un cinquième thème : Dusk. Définissez "theme": "dusk" dans docs.json pour un rendu calme et plat : corps de texte en Inter, titres en IBM Plex Serif, et une surface unique à l'accent bleu encre séparée par des bordures de 1px plutôt que des cartes surélevées. Les couleurs, polices et surcharges CSS personnalisées fonctionnent comme sur Jam, Nebula, Pulsar et Halo. Thèmes →
Personnalisez vos cartes sociales. Ajoutez seo.socialCard à docs.json pour modifier la carte que Jamdesk génère pour chaque page. Vous pouvez colorer la barre et le badge de section avec votre colors.primary, passer à une carte sombre, masquer la barre ou le nom du site, ou afficher votre propre og:image comme carte entière, sans texte dessus. Les cartes restent identiques tant que vous n'ajoutez pas ces paramètres. SEO →
Exemples de CSS et JavaScript personnalisés. Un nouveau guide habille l'en-tête avec votre logo et vos couleurs et ajoute un bouton flottant pour l'IA, avec des captures en mode clair, en mode sombre et sur téléphone. Il faut un style.css, un script.js et quelques lignes de docs.json. Les sélecteurs sont des points d'accroche stables et non des noms de classe, donc vos modifications tiennent après les mises à jour de Jamdesk. Exemples CSS et JS →
Un llms-full.txt par langue. Les sites multilingues publient désormais un fichier de contenu complet pour chaque langue, à côté de son index, comme /fr/llms-full.txt pour le français et /en/llms-full.txt pour votre langue par défaut. L'index de votre langue par défaut répond à la fois à /en/llms.txt et à /llms.txt, si bien que chaque langue suit le même modèle d'URL. Un agent peut charger uniquement la langue dont il a besoin, plutôt que toutes les pages dans toutes les langues. Le fichier racine /llms-full.txt contient toujours toutes les langues, donc les outils qui le lisent déjà ne voient aucun changement. Les sites monolingues restent inchangés. llms.txt →
Envoyez vos lecteurs directement vers leur propre langue. Définissez "localization": { "autoRedirect": true } dans docs.json et un visiteur venu pour la première fois, dont le navigateur demande le français, arrive sur /fr au lieu de votre langue par défaut. Son choix est conservé pendant un an, et le fait de choisir une langue dans le sélecteur le remplace. Seule la racine de votre site est jamais redirigée : une URL de langue comme /fr et un lien profond comme /guides/authentication s'ouvrent tous deux exactement comme demandé, pour tout le monde, si bien qu'un lien que vous collez dans un ticket ouvre la même page pour la personne qui clique dessus. Les robots d'indexation ne sont eux non plus jamais redirigés, donc vos balises hreflang continuent de décider ce qui est indexé. Désactivé par défaut ; nécessite au moins deux langues configurées. Routage automatique des langues →
Redéfinissez la date de « dernière mise à jour » d'une page. Le metadata.timestamp de docs.json affiche déjà une ligne « Dernière mise à jour le … » construite à partir du dernier commit Git de la page. Ajoutez lastUpdatedDate: "2026-09-01" au frontmatter d'une page et cette date remplace celle du commit dans le pied de page. Elle alimente aussi le <lastmod> de votre sitemap et le dateModified des données structurées de la page, que le pied de page soit affiché ou non, afin que les moteurs de recherche et les assistants IA voient la même date que vos lecteurs. Utile après avoir relu une page, ou lorsqu'un commit de mise en forme a déplacé la date sans rien changer qu'un lecteur remarquerait. Frontmatter →
Désactivez le bouton de copie d'un bloc de code. Ajoutez nocopy à la ligne d'ouverture du bloc de code et ce bloc perd son bouton de copie tandis que tous les autres le conservent ; cela se combine avec un titre et toutes les autres options de bloc, et fonctionne par onglet à l'intérieur d'un <CodeGroup>. Utilisez-le pour les transcriptions de terminal, les exemples caviardés et les extraits « ne faites pas ça » — partout où copier le texte affiché donnerait au lecteur quelque chose qui ne fonctionne pas. Blocs de code →
Connectez vos lecteurs avec votre propre système de connexion. L'authentification JWT protège un site de documentation derrière le système de connexion que vous utilisez déjà, pour que personne n'ait à saisir un mot de passe partagé. Activez auth.jwt dans docs.json, générez une clé de signature Ed25519 dans Settings, et faites signer par votre backend un jeton de courte durée lorsqu'un utilisateur ouvre la documentation. Jamdesk le vérifie et démarre une session par utilisateur pouvant durer jusqu'à 30 jours. Ajoutez groups: ["admin"] à une page et seuls les visiteurs dont le jeton porte ce groupe pourront l'ouvrir ou la voir dans la barre latérale ; tous les autres obtiennent une 404. Les chemins publics, le public: true du frontmatter et les groupes de navigation publics laissent un journal des modifications ou une page de statut ouverts. Vous pouvez aussi préremplir le playground de l'API avec les identifiants du visiteur extraits du jeton. Inclus dans toutes les offres, et vous pouvez migrer depuis la protection par mot de passe sans aucune interruption de couverture. Authentification JWT →
La racine du site exporte aussi du Markdown. Récupérez la racine de votre documentation, ou une racine de langue comme /fr, avec Accept: text/markdown ou via /index.md, et vous obtenez la première page de cette navigation, la même page que montre la racine HTML. Les sites sans index.mdx renvoyaient auparavant une 404 ici, ce qui cassait la première requête que font la plupart des agents. Source Markdown →
Jamdesk traduit votre documentation en 27 langues. Cochez les langues que vous voulez, jusqu'à cinq par projet, dans Settings → Translations, et après chaque build, les pages traduites sont commitées dans votre dépôt GitHub. Les builds suivants ne retraduisent que les pages dont la source anglaise a changé. Les traductions que vous aviez déjà, ou que vous avez modifiées à la main, sont conservées jusqu'à ce que vous cliquiez sur Replace with AI translation. Inclus dans toutes les offres. Traduction par IA →
Choisissez votre propre URL de documentation. L'hébergement en sous-chemin n'est plus limité à /docs. Saisissez un seul segment, comme help ou guide, dans le champ de sous-chemin de la carte Custom Domain, puis enregistrez. /docs continue de fonctionner, les URL canoniques basculent immédiatement vers le nouveau chemin, et l'ancien sous-chemin personnalisé redirige vers le nouveau pour un seul renommage, ce qui vous permet de mettre à jour votre proxy à votre propre rythme. Hébergement en sous-chemin →
Fix with AI, encore plus rapide. Ouvrir l'aperçu des correctifs depuis la bannière de build se termine plus vite, y compris sur les grands sites, et le rouvrir est quasi instantané car Jamdesk conserve les résultats de l'analyse tant que votre documentation n'a pas changé. Le déroulé reste le même : passez en revue chaque modification proposée, appliquez celles que vous approuvez, et Jamdesk les commite et relance un build. Fix with AI →
Un quatrième thème : Halo. Définissez "theme": "halo" dans docs.json pour un rendu chaleureux et arrondi : la police Figtree, un fond sable avec le contenu surélevé sur une carte, et les plus grands rayons d'angle de tous les thèmes intégrés. Les couleurs personnalisées, les polices et les surcharges CSS fonctionnent de la même façon que sur Jam, Nebula et Pulsar. Thèmes →
Servez votre documentation uniquement depuis votre propre domaine. Activez Custom domain only dans la carte Custom Domain et une visite directe à YOUR_SLUG.jamdesk.app renvoie une 404, tandis que votre CNAME ou votre proxy continuent de fonctionner. Jamdesk vérifie votre domaine actif avant d'activer le bouton, et si votre DNS tombe en panne, le sous-domaine recommence à servir jusqu'à ce qu'il soit rétabli. Cela masque le sous-domaine aux visiteurs directs mais ne contrôle pas qui peut lire votre documentation ; associez-le à la protection par mot de passe pour cela. Domaine personnalisé uniquement →
Construisez toute votre référence API à partir d'une spécification. Pointez un onglet de navigation vers votre fichier OpenAPI avec "openapi": { "source": "/openapi/api.yaml", "generate": true } et chaque build crée une page par opération, regroupées dans la barre latérale par tag. Une page d'endpoint commitée conserve son slug, ce qui vous permet de migrer une page à la fois, et un chemin renommé redirige depuis son ancienne URL au lieu de renvoyer une 404. Pages API générées →
Les lecteurs choisissent le serveur d'API qu'ils regardent. Un endpoint dont la spécification liste plus d'une entrée servers affiche un sélecteur à côté de son URL. Choisir sandbox change l'URL de base, le bouton de copie, chaque exemple de code et la requête envoyée par le playground, pour que personne ne copie un curl de production depuis votre documentation sandbox. Les endpoints à serveur unique restent inchangés. Playground de l'API →
Le Markdown s'affiche dans toutes les descriptions OpenAPI. Les tableaux, les listes, les liens, le code et le gras s'affichent désormais de la même façon dans les descriptions de paramètre, de corps de requête, de réponse et de schéma que dans la description de l'opération. Neuf emplacements étaient auparavant incohérents, et ils partagent désormais tous le même moteur de rendu. Exemple OpenAPI →
Les exports Markdown des endpoints incluent l'authentification. Récupérez la version .md d'une page de référence API et elle se termine par une section ## Authentication listant les schémas dont l'opération a besoin : type, nom d'en-tête, format du bearer, scopes OAuth 2, et quelles combinaisons sont valides. Un agent qui lit l'export peut construire une requête fonctionnelle sans ouvrir votre spécification. Source Markdown →
Gardez une page hors de la recherche sans la masquer. Ajoutez search: false au frontmatter d'une page et elle disparaît de la recherche du site, des réponses du chat IA et du serveur MCP, tout en restant dans votre barre latérale, votre sitemap et votre llms.txt. Utilisez-le pour une page remplacée que vous voulez pouvoir encore lier et indexer. Les pages masquées et non indexées sont désormais elles aussi écartées des réponses IA, ce qui n'était pas le cas avant. Garder une page hors de la recherche uniquement →
jamdesk validate signale la configuration qui ne fait rien. Certaines clés de docs.json étaient acceptées sans jamais être rendues, asyncapi en tête, si bien qu'une configuration semblait prise en charge jusqu'à ce que vous construisiez le site et ne trouviez rien. La commande les nomme, ainsi que les entrées api.mdx.server au-delà de la première, qui ont toujours été ignorées. Aperçu du CLI →
Modifiez votre documentation directement dans le dashboard. L'éditeur web est désormais disponible pour tout le monde et ne nécessite aucune configuration. Ouvrez Editor dans la barre latérale pour parcourir votre dépôt connecté, modifier du MDX avec un aperçu en direct, et commiter directement sur votre branche GitHub, ce qui déclenche automatiquement un build. Éditeur web →
Corrigez les avertissements de build avec l'IA, depuis le dashboard. Lorsqu'un build se termine avec des liens cassés ou des pages sans description, une bannière Fix with AI apparaît désormais sur le build, indiquant combien de problèmes peuvent être corrigés. Ouvrez-la pour prévisualiser chaque modification proposée (ancres réécrites et descriptions de page suggérées), puis appliquez celles que vous approuvez. Jamdesk les commite sur votre branche GitHub et démarre un nouveau build. Tout ce qui ne peut pas être résolu sans ambiguïté est listé séparément pour que vous le corrigiez à la main. Fix with AI →
Membres d'équipe illimités. Chaque projet inclut désormais un nombre illimité de membres d'équipe sur toutes les offres, sans coût supplémentaire. La limite précédente de 10 membres et la tarification par siège ont disparu — invitez toute votre équipe.
Laissez des bots de confiance publier votre documentation. Les comptes d'automatisation comme Dependabot, Renovate ou un bot de publication CMS ne sont pas des membres Jamdesk, donc leurs push ne déclenchent pas de build par défaut. Désormais, quand l'un d'eux est refusé, le build affiche un bouton Authorize Bot Account en un clic. Approuvez-le, et les push de ce compte publient sur votre site en production, comme ceux d'un membre de l'équipe. Seuls les membres du projet peuvent autoriser un compte, et vous pouvez consulter ou révoquer l'accès à tout moment sous Allowed automation accounts dans les paramètres GitHub de votre projet.
Votre documentation reçoit un score IA à chaque build. Jamdesk évalue désormais la capacité des agents IA à lire votre documentation publiée — noté selon la norme ouverte AFDocs — automatiquement après chaque build, directement dans le dashboard. Consultez votre score de 0 à 100 et sa note en lettre, suivez son évolution build après build, et obtenez une correction en langage clair pour chaque problème, chacune avec un bouton Copy prompt to fix qui transmet le constat à votre agent de codage IA. Activez Email team when score changes pour être informé quand un build fait bouger votre score de façon significative. Score IA →
Corrigez automatiquement les liens cassés. Les avertissements de lien interne cassé avec une cible non ambiguë — ancres mal orthographiées et dérive d'ancre entre langues — peuvent désormais être corrigés d'une seule commande. Lancez jamdesk fix --dry-run pour prévisualiser les changements prévus, puis jamdesk fix pour les appliquer ; seuls les avertissements dont l'ancre correcte correspond à un titre réel sont modifiés, laissant les cas ambigus pour une relecture manuelle. Aperçu du CLI →
Annoncez n'importe quoi avec une bannière. Ajoutez un banner à votre docs.json et une barre de message s'épingle en haut de chaque page — au-dessus de l'en-tête, dans la couleur d'accent de votre thème. Utilisez des liens, du gras et de l'italique en ligne, et définissez dismissible: true pour donner aux lecteurs un bouton de fermeture (elle reste fermée jusqu'à ce que vous changiez le message). Bannière →
Affichez la date de dernière mise à jour de chaque page. Définissez metadata.timestamp: true dans votre docs.json et chaque page reçoit dans son pied de page une ligne du type « Dernière mise à jour le 15 juin 2026 ». La date provient du dernier commit Git ayant modifié la page, donc elle reste exacte à chaque build sans maintenance manuelle des dates. Métadonnées de page →
Personnalisez vos icônes de navigation. Les icônes de la barre latérale, des groupes, des onglets, des ancres et de la recherche respectent désormais le style défini sur un objet icône ({ "name": "rocket", "style": "duotone" }) ou un préfixe de style (duotone/rocket) — light, thin, duotone et la famille sharp, pas seulement solid. Icônes →
Personnalisez la barre de recherche. Choisissez votre propre texte d'espace réservé avec search.prompt, et composez les liens rapides que voient les visiteurs dans le panneau de recherche vide avec search.popularPages — chacun avec un titre, un slug de page et une icône Font Awesome. Configuration de la recherche →
Collectez des inscriptions par e-mail sans intégration requise. Connectez Resend, Mailchimp, Kit, Loops, beehiiv, Brevo ou SendGrid dans Integrations → Email Signups, et un formulaire hébergé par Jamdesk ajoute les lecteurs directement à votre propre audience — votre clé API reste sur notre backend, jamais dans votre site publié. Ajoutez le composant EmailSubscribe à n'importe quelle page, ou définissez placement: changelog pour ajouter automatiquement un encart d'inscription sur chaque page de journal des modifications. Inscriptions par e-mail →
Bloquez l'analytique derrière le consentement aux cookies. Ajoutez une clé integrations.cookies à votre docs.json et Jamdesk retient chaque script d'analytique et de suivi — Google Analytics, GTM, Plausible, Crisp, JavaScript personnalisé et son propre outil d'analytique intégré — jusqu'à ce qu'un visiteur consente, une valeur lue depuis un indicateur localStorage que votre bannière de consentement définit. Chargez aussi une bannière Osano ou Termly directement depuis docs.json ; un court script passerelle bascule l'indicateur dès qu'un lecteur accepte, et les scripts se chargent sans recharger la page. Consentement aux cookies →
llms.txt, organisé. Le llms.txt de chaque site suit désormais la structure de llmstxt.org — vos onglets et groupes de navigation deviennent des sections ##, si bien que les agents IA voient votre documentation comme votre barre latérale l'organise. Les sites multilingues obtiennent un index par langue : le fichier racine liste votre langue par défaut et renvoie vers chaque index traduit (par exemple /fr/llms.txt), en gardant chacun assez petit pour qu'aucun agent ne le tronque. llms.txt →
Les agents trouvent votre documentation plus vite. Chaque page porte désormais une directive invisible, silencieuse pour les lecteurs d'écran, qui pointe les agents IA vers llms.txt et la version .md de la page, et chaque export Markdown s'ouvre par une citation renvoyant vers l'index. Les agents qui récupèrent votre HTML n'ont plus à deviner qu'un chemin Markdown existe. Aperçu IA →
Intégrez votre journal des modifications n'importe où. Un lanceur « Quoi de neuf ? » s'ajoute à votre propre application avec une seule balise <script> et ouvre votre journal des modifications Jamdesk dans une fenêtre modale, avec un point de notification non lu par visiteur. Générez l'extrait depuis Integrations → What's New widget, puis ajustez le mode du lanceur, le coin, la taille de la modale et la couleur du point avec des attributs data-. Dans votre propre documentation Jamdesk, le composant MDX <Widget> place ce même lanceur en direct sur n'importe quelle page avec une seule balise et sans script. Intégrer votre journal des modifications →
Téléchargez vos spécifications API sous forme de zip. Sur n'importe quelle page de référence API, le menu AI Actions propose désormais une option Download API spec qui regroupe chaque spécification OpenAPI référencée par votre site — fichiers locaux et URL distantes confondus — dans un unique api-specs.zip. Les spécifications multi-fichiers conservent leur arborescence de $ref, si bien que le téléchargement s'importe directement dans Postman, un générateur de client ou votre propre outillage. AI Actions →
Les spécifications OpenAPI sont validées au moment du build. Chaque déploiement valide désormais strictement les spécifications OpenAPI référencées par votre docs.json — et signale tout problème comme un avertissement de build non bloquant au lieu de faire échouer le build. Votre documentation est quand même publiée ; vous êtes simplement informé précisément de ce qui ne va pas (une erreur d'analyse YAML avec ligne et colonne, un $ref non résolu, ou un operationId en double) par e-mail et dans la liste des builds du dashboard. En local, jamdesk dev s'arrête toujours sur une spécification invalide, pour que vous le remarquiez avant de pousser. Aperçu du CLI →
Posez une question à l'IA directement depuis la recherche. Commencez à taper dans la recherche, puis transmettez votre question au chat IA au lieu d'ouvrir un résultat — appuyez sur ⌘/Ctrl+Entrée ou cliquez sur Ask AI dans le pied de la recherche. La question est ajoutée à votre conversation de chat pour que vous puissiez garder un fil, et un simple Entrée continue de sauter au premier résultat. Chat IA →
Copiez les réponses et les transcriptions. Chaque réponse du chat IA a un bouton de copie qui récupère la source Markdown, et une action Copy transcript dans l'en-tête du chat copie toute la conversation en Markdown avec le rôle de chaque intervenant — pratique pour la coller dans un ticket ou une documentation. Chat IA →
Défilement automatique du chat plus intelligent. Le chat ne suit une réponse en streaming que si vous êtes déjà en bas. Remontez pour relire une réponse précédente et il reste en place au lieu de vous ramener en bas de force ; redescendez tout en bas et il se réépingle.
CSS personnalisé en aperçu local (CLI). jamdesk dev applique votre CSS personnalisé de la même façon que le build publié, pour que vous puissiez vérifier le style avant de déployer. Déposez n'importe quel fichier .css à la racine de votre projet — style.css, ou plusieurs combinés par ordre alphabétique — et il se charge au rafraîchissement du navigateur. Aucune entrée docs.json n'est nécessaire, comme Mintlify le fait pour les feuilles de style à la racine. CSS personnalisé →
Aperçus sociaux personnalisés depuis le frontmatter. Définissez n'importe quelle balise meta Open Graph ou Twitter/X directement dans le frontmatter d'une page — og:title, og:description, og:image, twitter:card, keywords, et l'ensemble complet des balises meta. Utilisez des clés plates de premier niveau ou un bloc seo: imbriqué ; les deux fonctionnent, et les valeurs par page surchargent les valeurs par défaut de votre docs.json. SEO →
Pages masquées. Gardez des brouillons, des manuels internes ou des guides obsolètes hors de votre barre latérale et des résultats de recherche sans les supprimer. Ajoutez hidden: true au frontmatter d'une page, ou à un groupe ou un onglet dans docs.json. Les pages masquées restent accessibles par URL directe mais disparaissent de la navigation, du sitemap, de la recherche sur site et du contexte IA — et reçoivent automatiquement une balise noindex. Besoin d'un groupe masqué dont les pages se classent quand même dans la recherche ? Ajoutez searchable: true en plus de hidden. Pages masquées →
Décorations grille et fenêtres. Deux nouveaux motifs de fond rejoignent le dégradé par défaut du thème Jam. Définissez background.decoration sur "grid" pour une subtile grille de points de 24 px, ou sur "windows" pour deux taches givrées façon Windows 11 dans les coins supérieurs. Le dégradé et le remplissage uni "none" fonctionnent toujours comme avant — choisissez le rendu qui correspond à votre marque. Arrière-plan →
Personnalisation de l'arrière-plan. Un nouveau bloc background dans docs.json désactive le dégradé du mode clair de Jam, redéfinit la couleur de page par mode, ou ajuste la couleur, la taille, la position et l'opacité du dégradé. Aucun CSS personnalisé n'est nécessaire. Arrière-plan →
Diagrammes D2. Un deuxième langage de diagrammes rejoint Mermaid. Balisez un bloc de code d2 et Jamdesk le rend en SVG au moment du build, avec les thèmes clair et sombre intégrés. Même flux de travail que Mermaid — choisissez le langage qui convient au diagramme que vous dessinez. Diagrammes D2 →
Résultats de recherche regroupés. La recherche ne répète plus la même page pour chaque section correspondante. Les résultats se regroupent sous leur page parente dans la fenêtre de recherche, avec jusqu'à trois sections visibles par défaut et un élément dépliant en ligne pour le reste. La mise en évidence des extraits reste en place — vous trouvez la bonne section en moins de passages.
Détection automatique de docs.json à la connexion. Connecter un dépôt GitHub trouve votre docs.json où qu'il se trouve. Le flux de connexion scanne tout l'arbre et signale un mint.json Mintlify s'il en trouve un à la place. Les monorepos et les configurations imbriquées fonctionnent sans configuration manuelle. Connexion à GitHub →
Indices d'emplacement de docs.json dans le CLI. Les configurations mal placées sont plus faciles à repérer. jamdesk validate, jamdesk dev et jamdesk doctor indiquent où se trouve réellement votre docs.json — ou où il devrait aller — au lieu d'une erreur générique « introuvable ». Corrigez-le en quelques secondes au lieu de décoder une trace d'erreur. Aperçu du CLI →
Hreflang conforme aux standards. Les balises hreflang émettent désormais des codes BCP 47 valides. Les dossiers de locale comme cn, jp et ja-jp sont associés aux codes que les moteurs de recherche attendent réellement (zh, ja), avec des URL de sitemap correctement échappées en XML. Chaque page localisée se classe dans sa propre région au lieu d'être traitée comme un contenu dupliqué. Langues →
Export PDF. Générez tout votre site de documentation en un seul PDF depuis Settings → PDF Exports dans le dashboard. Réservé aux offres payantes. Les projets multilingues choisissent une locale par export, les résultats sont mis en cache par commit, et vous recevez un e-mail avec un lien de téléchargement une fois le rendu terminé.
Spécifications OpenAPI multilingues. Les pages d'endpoint affichent des spécifications OpenAPI traduites aux côtés du MDX traduit. Déposez un fichier <spec>.<lang>.<ext> (par exemple openapi/api.fr.yaml) à côté de votre spécification source et Jamdesk le prend en compte sur les URL de cette langue, en revenant à la spécification anglaise quand une variante de langue manque. Les résumés d'opération, les descriptions de paramètre, les descriptions de réponse et les descriptions de schéma sont tous localisés. Configuration : Traduire les spécifications OpenAPI.
Composant Visibility. Le nouveau composant <Visibility for="humans|agents"> permet de réserver du contenu aux lecteurs humains ou aux agents IA sur une même page. Les blocs réservés aux humains s'affichent dans le navigateur mais sont retirés des exports .md et de llms-full.txt ; les blocs réservés aux agents font l'inverse. Les agents qui demandent Accept: text/markdown sur les URL canoniques reçoivent automatiquement la vue agent.
Protection par mot de passe, reconstruite. Verrouillez tout votre site derrière un mot de passe partagé, ou protégez seulement quelques pages en laissant le reste public. Définissez auth.password.enabled: true pour le mode site entier, ou marquez des pages individuelles avec private: true dans le frontmatter (ou listez-les sous auth.password.private) pour le mode pages spécifiques. La page Settings du dashboard vous guide pour définir, faire tourner et révoquer le mot de passe. Les visiteurs arrivent sur un écran de déverrouillage à votre image, avec le logo de votre site, sa couleur principale et un indice optionnel que vous définissez dans docs.json. Guide de configuration : Protection par mot de passe.
Conversion automatique des images en WebP. Jamdesk peut convertir vos images PNG et JPG en WebP au moment du build. Les fichiers convertis sont généralement 60 à 80 % plus légers que les originaux sans perte de qualité visible, si bien que vos pages se chargent plus vite sans aucun traitement d'image manuel. Activez-le via images.convertToWebp: true dans docs.json. Les favicons, og:image et twitter:image conservent leur format d'origine pour la compatibilité avec les robots des réseaux sociaux. Une nouvelle étape Optimizing images affiche une progression en direct dans le dashboard et le CLI à chaque build. Conversion automatique des images →
Playground de l'API. Les pages d'endpoint ont désormais un bouton interactif « Try it ». Renseignez les paramètres, observez les exemples de code se mettre à jour en temps réel, et envoyez des requêtes réelles sans quitter votre documentation. Activé par défaut sur toutes les pages API. Fonctionne avec les endpoints OpenAPI comme avec ceux écrits en MDX.
Plugin Claude Code. Installez le plugin Jamdesk pour Claude Code pour donner à Claude une connaissance approfondie des composants MDX, de la configuration docs.json, des schémas de navigation et des commandes du CLI. Installation en deux étapes depuis la marketplace de plugins. Se combine avec CLAUDE.md et le serveur MCP pour la rédaction de documentation assistée par IA.
Avertissements de build pour l'image de marque manquante. Les builds signalent désormais quand les chemins favicon ou logo dans docs.json référencent des fichiers absents de votre projet. Les avertissements apparaissent dans le détail des builds du dashboard et dans le CLI via jamdesk dev et jamdesk validate. Aucun e-mail n'est envoyé ; l'avertissement est purement informatif.
YouTube Shorts. Le composant <YouTube> prend en charge les Shorts verticaux via la prop short, affichant un lecteur 9:16 centré sans bandes noires. Utilisez <YouTube id="VIDEO_ID" short />.
Menu AI Actions. Un menu déroulant sur chaque page permet aux lecteurs de copier le Markdown, d'ouvrir la page dans ChatGPT/Claude/Perplexity, de récupérer la configuration du serveur MCP, ou de l'installer en un clic dans Cursor ou VS Code. Activé par défaut ; choisissez les options affichées via contextual dans docs.json.
Analytique. Une analytique de page sans cookies qui suit les vues, les sources de trafic et les tendances des visiteurs avec des répartitions par page. Aucune bannière de consentement n'est nécessaire. Vue d'ensemble : Analytique.
Intégrations. Google Analytics 4, Google Tag Manager, Plausible Analytics, et notifications de build Slack (Pro).
Flux RSS pour les journaux des modifications. Les pages avec rss: true dans le frontmatter génèrent désormais automatiquement un flux RSS auquel s'abonner. Une icône RSS apparaît à côté du titre de la page, et un feed.xml est construit à partir de vos composants Update à chaque build. Utilisez la nouvelle prop date sur Update pour des dates de flux correctes.
Connexion et déploiement en CLI. jamdesk login authentifie via le navigateur. jamdesk deploy empaquette votre projet et déclenche un build depuis le terminal. Aucune connexion GitHub n'est requise. Le CLI respecte le .gitignore, avertit des fichiers secrets, et affiche la progression du build en direct.
Vérification orthographique en CLI. jamdesk spellcheck vérifie votre documentation à la recherche de fautes d'orthographe avec plus de 180 termes techniques intégrés (anglais uniquement). jamdesk spellcheck --fix lance un mode interactif pour corriger les fautes de frappe ou ajouter des mots à votre liste d'exclusions.
Intégrations vidéo. Intégrez des fichiers .mp4 et .webm directement dans votre documentation. Déposez-les dans un dossier /videos et utilisez la syntaxe Markdown (<Video src="/_jd/videos/demo.mp4?v=mvayckfq" title="Demo" />) ou le composant <Video> pour la lecture automatique, la boucle et d'autres contrôles.
JavaScript personnalisé. Ajoutez des scripts côté client pour des widgets de chat, de l'analytique ou des intégrations tierces via styling.js dans docs.json.
Chat IA. Un assistant de chat intégré sur chaque site de documentation. Les visiteurs posent des questions et obtiennent des réponses avec des liens de citation vers les pages source. Propulsé par Claude, activé sur toutes les offres.
Intégration IA. Chaque site génère un llms.txt pour les fenêtres de contexte des LLM, expose du Markdown brut sur des URL .md, et inclut un serveur MCP sur /_mcp avec les outils searchDocs et getPage. Guides de configuration pour Claude Code, Cursor et Codex. Voir aussi : Rédiger avec l'IA et Mises à jour automatisées.
CLI. jamdesk dev pour l'aperçu local avec rechargement à chaud, jamdesk validate pour les liens cassés, jamdesk migrate pour convertir depuis Mintlify/GitBook/Docusaurus, jamdesk doctor pour les problèmes de configuration. Installation via npm, curl ou Homebrew. Référence complète →
Extension VS Code. Démarrez, arrêtez et redémarrez le serveur de développement depuis la barre d'état de VS Code ; aucun terminal n'est nécessaire.
Vérification TXT du domaine personnalisé. Tous les domaines personnalisés nécessitent désormais un enregistrement TXT (_jamdesk.yourdomain.com) avant l'activation du routage. Cela empêche le détournement de domaine sur des sous-domaines non revendiqués. Les domaines nouvellement ajoutés voient l'enregistrement TXT dans le parcours de configuration du dashboard. Voir le guide des domaines personnalisés.
Support multilingue. Définissez des arborescences de navigation et des répertoires de contenu distincts par locale. Les lecteurs changent de langue depuis un menu déroulant dans la barre supérieure.
Analytique de recherche. Ce que cherchent les lecteurs, quelles requêtes ne renvoient rien, et quels résultats sont réellement cliqués. Utile pour repérer les lacunes de contenu.
Jamdesk est lancé. Rédigez votre documentation en MDX, poussez-la sur GitHub, obtenez un site sur un CDN mondial. Les builds se terminent en moins de 60 secondes.
MDX et composants. Plus de 20 composants intégrés : onglets, accordéons, étapes, groupes de code, diagrammes Mermaid, formules mathématiques KaTeX et icônes. Coloration syntaxique avec numéros de ligne dans les blocs de code. Créez des composants React personnalisés avec Tailwind et des hooks, et réutilisez du contenu avec des snippets. Vue d'ensemble des composants →
Documentation OpenAPI. Générez des pages de référence API à partir de votre spécification OpenAPI via api.openapi dans docs.json.
Déploiement. Déploiement automatique depuis GitHub à chaque push avec un délai de 10 s. Domaines personnalisés avec SSL automatique, hébergement en sous-chemin sur /docs (Vercel, CloudFront, Cloudflare, nginx), et prise en charge des monorepos.
Personnalisation. Trois thèmes (jam, nebula, pulsar) avec couleurs, logos et pied de page personnalisés. CSS personnalisé pour les surcharges de style. Navigation flexible avec onglets, groupes et icônes. Redirections avec correspondance exacte et par joker.
Recherche et SEO. Recherche plein texte Cmd+K, sans configuration. Sitemaps, images OG et métadonnées par page prêts à l'emploi.
Référence docs.json. Référence de configuration complète pour tous les paramètres et options.
Centre d'aide. Gestion de compte, facturation et guides de dépannage.
