In this episode, co-founders Boris and Geoff recap last month's feature releases.
Episode highlights:
- PDF Export. Render your whole docs site to a single PDF from Settings → PDF Exports in the dashboard. Paid plans only. Multi-language projects pick a locale per export, results are cached per commit, and you get an email with a download link when rendering finishes.
- Multi-language OpenAPI Specs. Endpoint pages now render translated OpenAPI specs alongside translated MDX. Drop a <spec>.<lang>.<ext> file (e.g., openapi/api.fr.yaml) next to your source spec and Jamdesk picks it up on that language's URLs, falling back to the English spec when a language variant is missing. Operation summaries, parameter descriptions, response descriptions, and schema descriptions all localize. Setup: Translating OpenAPI Specs.
- Visibility Component. New <Visibility for="humans|agents"> component lets you carve out content for human readers or AI agents on the same page. Human-only blocks render in the browser but are stripped from .md exports and llms-full.txt; agent-only blocks do the reverse. Agents requesting Accept: text/markdown on canonical URLs automatically get the agent view.
- Password Protection, rebuilt. You can now lock your whole site behind a shared password, or gate just a handful of pages while the rest stay public. Set auth.password.enabled: true for whole-site mode, or mark individual pages with private: true in frontmatter (or list them under auth.password.private) for specific-pages mode. The Settings page in the dashboard walks you through setting, rotating, and revoking the password. Visitors hit a branded unlock screen with your site's logo, primary color, and an optional hint you define in docs.json. Setup guide: Password Protection.
- Automatic WebP Image Conversion. Jamdesk can convert your PNG and JPG images to WebP at build time. Converted files are usually 60-80% smaller than the originals with no visible quality loss, so your pages load faster without any manual image processing. Opt in via images.convertToWebp: true in docs.json. Favicons, og:image, and twitter:image stay in their original format for social crawler compatibility. A new Optimizing images step shows live progress in the dashboard and CLI during each build. Automatic Image Conversion →
- API Playground. Endpoint pages now have an interactive "Try it" button. Fill in parameters, watch code examples update in real time, and send live requests without leaving your docs. Enabled by default on all API pages. Works with both OpenAPI and MDX-authored endpoints.
- Claude Code Plugin. Install the Jamdesk plugin for Claude Code to give Claude deep knowledge of MDX components, docs.json configuration, navigation patterns, and CLI commands. Two-step install from the plugin marketplace. Pairs with CLAUDE.md and the MCP server for AI-assisted doc writing.
- Build Warnings for Missing Branding. Builds now warn when favicon or logo paths in docs.json reference files that don't exist in your project. Warnings appear in the dashboard build details and in the CLI via jamdesk dev and jamdesk validate. No email; the warning is informational only.
- YouTube Shorts. The <YouTube> component now supports vertical Shorts via the short prop, rendering a centered 9:16 player with no black bars. Use <YouTube id="VIDEO_ID" short />.
What is The API Docs Podcast?
The founders of Jamdesk run through all the new updates of Jamdesk.