Veja as novidades do Jamdesk, plataforma de documentação em MDX, GitHub e APIs, com lançamentos, atualizações da CLI e mudanças na plataforma.
Get Jamdesk release notes
New features and platform changes, straight to your inbox.
Sua equipe entra sem digitar a senha. Adicione "allowMembers": true em auth.password no docs.json. A tela de desbloqueio ganha um botão Sign in with Jamdesk, e o dono e os membros do projeto leem a documentação com a própria conta Jamdesk. Leitores externos continuam usando a senha compartilhada. Se você não definir uma senha, o site fica aberto só para a sua equipe. Requer um plano pago. Proteção por senha →
Mais controle sobre o rodapé. Adicione copyright a footer e a linha aparece no fim de cada página. Cada idioma em navigation.languages também pode ter o próprio footer, assim quem lê em francês vê links em francês. O rodapé também tem nomes de classe estáveis como .jd-footer-column-title e .jd-footer-social[data-platform="github"], então seu CSS personalizado continua funcionando entre versões. Suas páginas recebem os nomes de classe no próximo build. Para visualizar com jamdesk dev você precisa da CLI 1.1.231 ou posterior. Rodapé →
Banners de aviso e de perigo, e um banner por idioma. Defina banner.type como "warning" ou "danger" para uma barra âmbar ou vermelha, e dê a qualquer idioma em navigation.languages seu próprio banner. Requer a CLI 1.1.231 ou posterior. Banner →
Deixe a Jamdesk corrigir os avisos de build para você. Defina AI Fixes como Auto-fix em Settings e a Jamdesk faz commit de correções de links, títulos e descrições depois de cada build. Cada execução aparece em Build History com um botão Undo. jamdesk ai-fix muda a configuração pela CLI, e jamdesk fix --json entrega a lista de correções a um agente de IA. Requer a CLI 1.1.229 ou posterior. Fix with AI →
Publique sua documentação sem uma conta do GitHub. Clique em Continue without GitHub durante a configuração. A Jamdesk guarda sua documentação em um repositório privado, e você a edita no Editor do painel. Quando quiser, Move to GitHub copia a documentação e todo o histórico para um repositório seu, em qualquer plano. Documentação sem GitHub →
Edite no seu computador a documentação sem GitHub. O jamdesk pull baixa sua documentação como um repositório git. Edite à mão ou com um agente de programação com IA como o Claude Code e depois rode jamdesk deploy para publicar. Se alguém mudou a documentação na Jamdesk desde o seu último pull, o deploy avisa e o jamdesk pull mescla as mudanças. Requer a CLI 1.1.227 ou mais recente. Editar no seu computador →
Verifique no GitHub quando outra pessoa conectou sua conta do GitHub primeiro. Se outra conta da Jamdesk já usa a conta do GitHub, clique em Verify on GitHub e entre no GitHub. Depois você pode conectar os repositórios em que pode fazer push. Conectar o GitHub →
Saiba quando um push não gerou build. Um push de alguém que não é membro do seu projeto não gera build. O build com falha agora mostra quem fez o push e como resolver, e o proprietário do projeto recebe um e-mail com um link para convidar a pessoa, no máximo uma vez por semana por pessoa. GitHub →
Renomeie o botão Ask AI e dê a ele o seu próprio ícone. Adicione chat.label e chat.icon ao docs.json. O rótulo substitui "Ask AI" no botão do chat, no cabeçalho do painel e no atalho de pesquisa. O ícone pode ser um nome do Font Awesome, a URL de uma imagem ou uma imagem do seu projeto. Chat de IA →
Centralize ou alinhe à direita as abas superiores. Defina tabsAlignment como "center" ou "end" quando as suas abas ficarem no cabeçalho. O padrão, "start", as mantém à esquerda. Navegação →
Abra um diagrama Mermaid em tela cheia. Clique em um diagrama, ou foque nele e pressione Enter, para vê-lo maior. Escape o fecha. Adicione noZoom ao componente <Mermaid> para desativar isso naquele diagrama. As cores que você define com style e classDef agora permanecem iguais nos modos claro e escuro. Mermaid →
API de pesquisa e MCP em sites protegidos por login. A API de pesquisa agora funciona em sites com autenticação por senha ou JWT sem adicionar /_api/search aos seus caminhos públicos, porque ela verifica a sua chave de API em vez de um login. O servidor MCP aceita a mesma chave de API do projeto como Authorization: Bearer <key>. Sem ela, ele retorna um 401 que explica o que enviar, em vez de redirecionar para a sua página de login. Servidor MCP →
O JavaScript personalizado roda no jamdesk dev. O seu script.js agora roda na prévia local como no seu site publicado, então você pode testá-lo antes do push. Atualize a CLI para a versão 1.1.222 ou posterior para ter esse recurso. JavaScript personalizado →
Defina o formato dos títulos das suas páginas. Adicione seo.titleTemplate ao docs.json para alterar o título exibido na aba do navegador e nos resultados de busca. Cada %s é substituído pelo título da página: "%s | Acme" resulta em Primeiros passos | Acme, e "%s" sozinho omite o nome do site. Os títulos das prévias de links continuam mostrando apenas o título da página. SEO →
Encontre o texto que não aparece no seu logotipo SVG. O cartão social não consegue renderizar texto dentro de um logotipo SVG. Quando o logotipo SVG usado pelo cartão contém texto, o build agora exibe uma sugestão para converter o texto em contornos (paths). Ela aparece na lista de sugestões do dashboard, em jamdesk validate e em jamdesk dev. Logotipos indicados por uma URL completa não são verificados. SEO →
Um quinto tema: Dusk. Defina "theme": "dusk" em docs.json para obter uma aparência tranquila e plana: corpo em Inter, títulos em IBM Plex Serif, e uma única superfície com destaque azul tinta separada por bordas de 1px em vez de cartões elevados. Cores, fontes e substituições de CSS personalizadas funcionam da mesma forma que em Jam, Nebula, Pulsar e Halo. Temas →
Leve os leitores direto para o idioma deles. Defina "localization": { "autoRedirect": true } em docs.json e um visitante de primeira viagem cujo navegador pede francês cai em /fr em vez de no seu idioma padrão. A escolha dele vale por um ano, e selecionar um idioma no seletor a substitui. Somente a raiz do site é redirecionada: uma URL de idioma como /fr e um link profundo como /guides/authentication abrem exatamente como foram pedidos, para todo mundo, então um link que você cola em um chamado abre a mesma página para quem clicar. Rastreadores também nunca são redirecionados, então suas tags hreflang continuam decidindo o que é indexado. Desativado por padrão; exige dois ou mais idiomas configurados. Roteamento automático de idioma →
Substitua a data de "última atualização" de uma página. O metadata.timestamp do docs.json já exibe uma linha "Last updated on …" vinda do último commit do Git daquela página. Adicione lastUpdatedDate: "2026-09-01" ao frontmatter de uma página e essa data substitui a data do commit no rodapé. Ela também alimenta o <lastmod> do seu sitemap e o dateModified dos dados estruturados da página, com o rodapé ligado ou não, de modo que mecanismos de busca e assistentes de IA vejam a mesma data que seus leitores. Útil depois de revisar uma página, ou quando um commit de formatação moveu a data sem mudar nada que um leitor fosse notar. Frontmatter →
Desligue o botão de copiar em um bloco de código. Adicione nocopy ao bloco e ele perde o botão de copiar enquanto todos os outros mantêm o deles; combina com um título e com todas as demais opções e funciona por aba dentro de um <CodeGroup>. Use para transcrições de terminal, exemplos com dados omitidos e trechos de "não faça isso" — onde copiar o texto renderizado entrega ao leitor algo que não funciona. Blocos de código →
Permita que leitores entrem com seu próprio login. A autenticação JWT protege um site de documentação usando o sistema de login que você já executa, para que ninguém precise digitar uma senha compartilhada. Ative auth.jwt em docs.json, gere uma chave de assinatura Ed25519 em Settings e faça seu backend assinar um token de curta duração quando um usuário abrir a documentação. O Jamdesk verifica o token e inicia uma sessão por usuário que dura até 30 dias. Adicione groups: ["admin"] a uma página para que somente visitantes cujo token contenha esse grupo possam abri-la ou vê-la na barra lateral; todos os demais recebem um 404. Caminhos públicos, public: true no frontmatter e grupos de navegação públicos mantêm um changelog ou uma página de status aberta. Você também pode preencher previamente o playground de API com as credenciais do próprio visitante a partir do token. Incluído em todos os planos, e você pode migrar da proteção por senha sem nenhuma lacuna de cobertura. Autenticação JWT →
A raiz do site também exporta Markdown. Acesse a raiz da sua documentação, ou uma raiz de idioma como /fr, com Accept: text/markdown ou usando /index.md, e você receberá a primeira página dessa navegação, a mesma página exibida pela raiz HTML. Sites sem um index.mdx costumavam retornar 404 nesse caso, interrompendo a primeira solicitação feita pela maioria dos agentes. Fonte Markdown →
O Jamdesk traduz sua documentação para 27 idiomas. Selecione os idiomas desejados, até cinco por projeto, em Settings → Translations e, após cada build, as páginas traduzidas serão confirmadas no seu repositório do GitHub. Os builds seguintes traduzem novamente apenas as páginas cujo conteúdo em inglês mudou. As traduções que você já tinha ou editou manualmente são mantidas até você clicar em Replace with AI translation. Incluído em todos os planos. Tradução com IA →
Escolha seu próprio URL de documentação. A hospedagem em subcaminho não está mais vinculada a /docs. Insira um único segmento, como help ou guide, no campo de subcaminho do cartão Custom Domain e salve. /docs continua funcionando, os URLs canônicos mudam imediatamente para o novo caminho e o subcaminho personalizado anterior redireciona para o novo em uma única renomeação, permitindo atualizar seu proxy no seu próprio ritmo. Hospedagem em subcaminho →
Corrija com IA, agora mais rápido. Abrir a visualização da correção pelo banner de build termina mais rápido, inclusive em sites grandes, e reabri-la é quase instantâneo porque o Jamdesk mantém os resultados da análise até que sua documentação mude. O fluxo não mudou: revise cada edição proposta, aplique as que aprovar e o Jamdesk fará o commit e um novo build. Corrigir com IA →
Um quarto tema: Halo. Defina "theme": "halo" em docs.json para obter uma aparência acolhedora e arredondada: fonte Figtree, fundo cor de areia com o conteúdo elevado em um cartão e os maiores raios de canto entre todos os temas integrados. Cores, fontes e substituições de CSS personalizadas funcionam da mesma forma que em Jam, Nebula e Pulsar. Temas →
Sirva sua documentação somente pelo seu próprio domínio. Ative Custom domain only no cartão Custom Domain e uma visita direta a YOUR_SLUG.jamdesk.app retornará 404, enquanto seu CNAME ou proxy continuará funcionando. O Jamdesk verifica seu domínio ativo antes de ativar a opção e, se o DNS falhar, o subdomínio voltará a ser servido até se recuperar. Isso oculta o subdomínio de visitantes diretos, mas não controla quem pode ler sua documentação; para isso, combine-o com a proteção por senha. Somente domínio personalizado →
Gere toda a referência da sua API a partir de uma especificação. Aponte uma aba de navegação para seu arquivo OpenAPI com "openapi": { "source": "/openapi/api.yaml", "generate": true } e cada build criará uma página por operação, agrupada na barra lateral por tag. Uma página de endpoint confirmada mantém seu slug, permitindo migrar uma página por vez, e um caminho renomeado redireciona do URL antigo em vez de retornar 404. Páginas de API geradas →
Os leitores escolhem qual servidor de API estão consultando. Um endpoint cuja especificação liste mais de uma entrada em servers exibe um seletor ao lado do URL. Escolher o sandbox altera o URL base, o botão de cópia, todos os exemplos de código e a solicitação enviada pelo playground, para que ninguém copie um curl de produção da sua documentação de sandbox. Endpoints com um único servidor não mudam. Playground de API →
O Markdown é renderizado em todas as descrições OpenAPI. Tabelas, listas, links, code e negrito são renderizados da mesma forma nas descrições de parâmetros, corpos de solicitação, respostas e schemas como já eram na descrição da operação. Nove áreas apresentavam resultados diferentes; agora todas compartilham um único renderizador. Exemplo de OpenAPI →
As exportações Markdown de endpoints incluem autenticação. Busque a versão .md de uma página de referência de API e ela terminará com uma seção ## Authentication que lista os esquemas necessários para a operação: tipo, nome do cabeçalho, formato bearer, escopos OAuth 2 e quais combinações são válidas. Um agente que leia a exportação poderá criar uma solicitação funcional sem abrir sua especificação. Fonte Markdown →
Mantenha uma página fora da busca sem ocultá-la. Adicione search: false ao frontmatter de uma página e ela será removida da busca do site, das respostas do chat de IA e do servidor MCP, enquanto permanece na barra lateral, no sitemap e no llms.txt. Use isso para uma página substituída que você ainda queira manter acessível por link e indexada. Páginas ocultas e sem indexação também ficam fora das respostas de IA, o que não acontecia antes. Manter uma página somente fora da busca →
jamdesk validate avisa sobre configurações sem efeito. Algumas chaves de docs.json eram aceitas sem nunca serem renderizadas, especialmente asyncapi, fazendo com que uma configuração parecesse compatível até você gerar o site e não encontrar nada. O comando informa essas chaves, além das entradas adicionais de api.mdx.server após a primeira, que sempre foram descartadas. Visão geral da CLI →
Edite sua documentação diretamente no dashboard. O editor web agora está disponível para todos e não exige configuração. Abra Editor na barra lateral para navegar pelo repositório conectado, editar MDX com uma visualização ao vivo e confirmar diretamente na sua branch do GitHub, iniciando um build automaticamente. Editor web →
Corrija avisos de build com IA pelo dashboard. Quando um build termina com links quebrados ou páginas sem descrição, um banner Fix with AI aparece no build, mostrando quantos problemas podem ser corrigidos. Abra-o para visualizar cada edição proposta — âncoras reescritas e descrições de página sugeridas — e aplique as que aprovar. O Jamdesk confirma as alterações na sua branch do GitHub e inicia um novo build. Tudo que não puder ser resolvido sem ambiguidade será listado separadamente para correção manual. Corrigir com IA →
Membros de equipe ilimitados. Agora todos os projetos incluem membros de equipe ilimitados em todos os planos, sem custo adicional. O limite anterior de 10 membros e a cobrança por usuário foram removidos — convide toda a sua equipe.
Permita que bots confiáveis publiquem sua documentação. Contas de automação como Dependabot, Renovate ou um bot de publicação de CMS não são membros do Jamdesk, então os pushes delas não acionam um build por padrão. Agora, quando uma conta é recusada, o build exibe um botão Authorize Bot Account de um clique. Autorize-a para que os pushes dessa conta publiquem no seu site ativo, assim como os de um membro da equipe. Somente membros do projeto podem autorizar uma conta, e você pode revisar ou revogar o acesso a qualquer momento em Allowed automation accounts, nas configurações do GitHub do projeto.
Sua documentação recebe um AI Score em cada build. O Jamdesk agora avalia automaticamente, após cada build e diretamente no dashboard, o quanto os agentes de IA conseguem ler sua documentação publicada — com base no padrão AFDocs aberto. Veja sua pontuação de 0 a 100 e a nota por letra, acompanhe a tendência entre builds e receba uma correção em linguagem simples para cada problema, com um botão Copy prompt to fix que envia a descoberta ao seu agente de programação com IA. Ative Email team when score changes para receber uma notificação quando um build alterar significativamente sua pontuação. AI Score →
Corrija links quebrados automaticamente. Avisos de links internos quebrados com um destino inequívoco — âncoras com erros de digitação e divergências de âncoras entre localidades — agora podem ser corrigidos com um comando. Execute jamdesk fix --dry-run para visualizar as alterações planejadas e depois jamdesk fix para aplicá-las; somente avisos cuja âncora correta resolve para um heading real são alterados, deixando os casos ambíguos para revisão manual. Visão geral da CLI →
Anuncie qualquer coisa com um banner. Adicione um banner ao seu docs.json e uma barra de mensagem ficará fixada no topo de cada página — acima do cabeçalho, na cor de destaque do seu tema. Use links, negrito e itálico inline, e defina dismissible: true para oferecer aos leitores um botão de fechar; ela permanecerá fechada até você alterar a mensagem. Banner →
Mostre quando cada página foi atualizada pela última vez. Defina metadata.timestamp: true no seu docs.json e cada página receberá no rodapé uma linha no estilo "Last updated on June 15, 2026". A data vem do último commit do Git que alterou a página, mantendo-se precisa em cada build sem manutenção manual de datas. Metadados de página →
Personalize os ícones de navegação. Os ícones da barra lateral, dos grupos, das abas, das âncoras e da busca agora respeitam o style em um objeto de ícone ({ "name": "rocket", "style": "duotone" }) ou um prefixo de estilo (duotone/rocket) — light, thin, duotone e a família sharp, não apenas solid. Ícones →
Personalize a barra de busca. Escolha seu próprio texto de placeholder com search.prompt e selecione os links rápidos exibidos aos visitantes no painel de busca vazio com search.popularPages — cada um com título, slug de página e ícone do Font Awesome. Configuração da busca →
Colete inscrições por e-mail sem exigir embed. Conecte Resend, Mailchimp, Kit, Loops, beehiiv, Brevo ou SendGrid em Integrations → Email Signups, e um formulário hospedado pelo Jamdesk adicionará os leitores diretamente ao seu próprio público — sua chave de API permanece no nosso backend, nunca no site publicado. Adicione o componente EmailSubscribe a qualquer página ou defina placement: changelog para colocar automaticamente uma caixa de inscrição em todas as páginas de changelog. Inscrições por e-mail →
Proteja a análise com consentimento de cookies. Adicione uma chave integrations.cookies ao seu docs.json e o Jamdesk reterá todos os scripts de análise e rastreamento — Google Analytics, GTM, Plausible, Crisp, JavaScript personalizado e sua própria análise integrada — até que o visitante dê consentimento, lido de uma flag de localStorage definida pelo seu banner de consentimento. Carregue também um banner Osano ou Termly diretamente pelo docs.json; um pequeno snippet de integração altera a flag assim que o leitor aceita, e os scripts são carregados sem recarregar a página. Consentimento de cookies →
llms.txt, organizado. O llms.txt de cada site agora segue a estrutura do llmstxt.org — suas abas e grupos de navegação tornam-se seções ##, para que os agentes de IA vejam sua documentação organizada como na barra lateral. Sites multilíngues recebem um índice por idioma: o arquivo raiz lista seu idioma padrão e inclui links para cada índice traduzido, como /fr/llms.txt, mantendo cada arquivo pequeno o suficiente para que nenhum agente o trunque. llms.txt →
Os agentes encontram sua documentação mais rápido. Cada página agora contém uma diretiva invisível e silenciosa para leitores de tela que aponta os agentes de IA para llms.txt e para a versão .md da página, e cada exportação Markdown começa com uma citação em bloco que contém um link para o índice. Agentes que buscam seu HTML não precisam mais deduzir que existe um caminho Markdown. Visão geral de IA →
Incorpore seu changelog em qualquer lugar. Um launcher "What's new?" entra no seu próprio app com uma única tag <script> e abre seu changelog do Jamdesk em um modal, com um indicador de não lido por visitante. Gere o snippet em Integrations → What's New widget e ajuste o modo do launcher, o canto, o tamanho do modal e a cor do indicador com atributos data-. Na sua própria documentação do Jamdesk, o componente MDX <Widget> adiciona o mesmo launcher ativo a qualquer página com uma única tag e sem script. Incorporar seu changelog →
Baixe suas especificações de API como um zip. Em qualquer página de referência de API, o menu AI Actions agora tem uma opção Download API spec que reúne todas as especificações OpenAPI referenciadas pelo seu site — arquivos locais e URLs remotos — em um único api-specs.zip. Especificações com vários arquivos mantêm a estrutura de pastas $ref, para que o download possa ser usado diretamente no Postman, em um gerador de clientes ou nas suas próprias ferramentas. AI Actions →
Especificações OpenAPI validadas durante o build. Cada deploy agora valida rigorosamente as especificações OpenAPI referenciadas pelo seu docs.json e exibe qualquer problema como um non-fatal build warning, em vez de interromper o build. Sua documentação continua sendo publicada; você apenas recebe exatamente o erro por e-mail e na lista de builds do dashboard — um erro de análise YAML com linha e coluna, um $ref não resolvido ou um operationId duplicado. Localmente, jamdesk dev ainda interrompe o processo diante de uma especificação inválida, para que você possa corrigi-la antes do push. Visão geral da CLI →
Pergunte à IA diretamente pela busca. Comece a digitar na busca e envie sua pergunta ao chat de IA sem abrir um resultado — pressione ⌘/Ctrl+Enter ou clique em Ask AI no rodapé da busca. A pergunta é adicionada à conversa do chat para que você possa continuar o mesmo tópico, enquanto Enter ainda abre o primeiro resultado. Chat de IA →
Copie respostas e transcrições. Cada resposta do chat de IA tem um botão de cópia que obtém a fonte Markdown, e a ação Copy transcript no cabeçalho do chat copia toda a conversa como Markdown com os papéis identificados — útil para colar em uma issue ou documento. Chat de IA →
Rolagem automática mais inteligente no chat. O chat acompanha uma resposta transmitida somente quando você já está no final. Role para cima para reler uma resposta anterior e ele permanecerá no lugar, em vez de levar você para baixo; volte ao final e ele será fixado novamente.
CSS personalizado na visualização local (CLI). jamdesk dev aplica seu CSS personalizado da mesma forma que o build publicado, para que você possa verificar o estilo antes do deploy. Coloque qualquer arquivo .css na raiz do projeto — style.css ou vários arquivos combinados em ordem alfabética — e ele será carregado ao atualizar o navegador. Não é necessária nenhuma entrada no docs.json, seguindo o modo como o Mintlify inclui folhas de estilo na raiz. CSS personalizado →
Previews sociais personalizados pelo frontmatter. Defina qualquer metatag Open Graph ou Twitter/X diretamente no frontmatter de uma página — og:title, og:description, og:image, twitter:card, keywords e todo o conjunto de metatags. Use chaves simples no nível superior ou um bloco seo: aninhado; ambos funcionam, e os valores por página substituem os padrões do seu docs.json. SEO →
Páginas ocultas. Mantenha rascunhos, manuais internos ou guias obsoletos fora da barra lateral e dos resultados de busca sem excluí-los. Adicione hidden: true ao frontmatter de uma página ou a um grupo ou aba no docs.json. Páginas ocultas continuam acessíveis pelo URL direto, mas desaparecem da navegação, do sitemap, da busca no site e do contexto de IA — além de receberem automaticamente uma tag noindex. Precisa de um grupo oculto cujas páginas ainda apareçam na busca? Adicione searchable: true junto com hidden. Páginas ocultas →
Decorações de grade e janelas. Dois novos padrões de fundo se juntam ao gradiente padrão do tema Jam. Defina background.decoration como "grid" para uma grade sutil de pontos de 24 px ou como "windows" para dois pontos foscos no estilo do Windows 11 nos cantos superiores. O gradiente e o preenchimento plano "none" continuam funcionando como antes — escolha a aparência que combina com sua marca. Fundo →
Personalização do fundo. Um novo bloco background no docs.json desativa o gradiente do modo claro do Jam, substitui a cor da página por modo ou ajusta a cor, o tamanho, a posição e a opacidade do gradiente. Não é necessário CSS personalizado. Fundo →
Diagramas D2. Uma segunda linguagem de diagramas se junta ao Mermaid. Marque um bloco de código delimitado com d2 e o Jamdesk o renderizará como SVG durante o build, com temas claro e escuro integrados. O fluxo é igual ao do Mermaid — escolha a linguagem que melhor se adapta ao diagrama que você está desenhando. Diagramas D2 →
Resultados de busca agrupados. A busca não repete mais a mesma página para cada correspondência de seção. Os resultados são agrupados sob a página principal no modal de busca, com até três seções visíveis por padrão e um expansor inline para as demais. O destaque dos snippets permanece — você encontra a seção certa em menos verificações.
Detecção automática de docs.json ao conectar. Ao conectar um repositório do GitHub, o sistema encontra seu docs.json onde quer que ele esteja. O fluxo de conexão examina toda a árvore e sinaliza um mint.json do Mintlify caso encontre um. Monorepos e configurações aninhadas funcionam sem configuração manual. Conectar GitHub →
Indicações da localização de docs.json na CLI. Configurações no lugar errado ficam mais fáceis de identificar. jamdesk validate, jamdesk dev e jamdesk doctor informam onde seu docs.json está de fato — ou onde deveria estar — em vez de exibir um erro genérico de "not found". Corrija em segundos, sem precisar interpretar um stack trace. Visão geral da CLI →
Hreflang em conformidade com os padrões. As tags hreflang agora emitem códigos BCP 47 válidos. Pastas de localidade como cn, jp e ja-jp são mapeadas para os códigos esperados pelos mecanismos de busca (zh, ja), com URLs de sitemap escapados em XML. Cada página localizada é classificada na sua própria região, em vez de ser tratada como conteúdo duplicado. Idiomas →
Exportação para PDF. Renderize todo o seu site de documentação em um único PDF usando Settings → PDF Exports no dashboard. Disponível somente em planos pagos. Projetos multilíngues permitem escolher uma localidade por exportação, os resultados são armazenados em cache por commit e você recebe um e-mail com um link de download quando a renderização termina.
Especificações OpenAPI multilíngues. As páginas de endpoints renderizam especificações OpenAPI traduzidas junto com MDX traduzido. Coloque um arquivo <spec>.<lang>.<ext> — por exemplo, openapi/api.fr.yaml — ao lado da especificação de origem, e o Jamdesk o usará nos URLs desse idioma, recorrendo à especificação em inglês quando não houver uma variante. Resumos de operações, descrições de parâmetros, descrições de respostas e descrições de schemas são todos localizados. Configuração: Traduzir especificações OpenAPI.
Componente Visibility. O novo componente <Visibility for="humans|agents"> permite separar conteúdo para leitores humanos ou agentes de IA na mesma página. Blocos exclusivos para humanos são renderizados no navegador, mas removidos das exportações .md e de llms-full.txt; blocos exclusivos para agentes fazem o oposto. Agentes que solicitam Accept: text/markdown em URLs canônicos recebem automaticamente a visualização para agentes.
Proteção por senha, reformulada. Bloqueie todo o site atrás de uma senha compartilhada ou proteja apenas algumas páginas enquanto o restante permanece público. Defina auth.password.enabled: true para o modo de site completo ou marque páginas individuais com private: true no frontmatter, ou liste-as em auth.password.private, para o modo de páginas específicas. A página Settings no dashboard orienta você a definir, alterar e revogar a senha. Os visitantes verão uma tela de desbloqueio personalizada com o logotipo e a cor principal do site, além de uma dica opcional definida no docs.json. Guia de configuração: Proteção por senha.
Conversão automática de imagens para WebP. O Jamdesk pode converter imagens PNG e JPG para WebP durante o build. Os arquivos convertidos costumam ser 60–80% menores que os originais, sem perda visível de qualidade, fazendo suas páginas carregarem mais rápido sem processamento manual de imagens. Ative com images.convertToWebp: true no docs.json. Favicons, og:image e twitter:image permanecem no formato original para compatibilidade com rastreadores sociais. Uma nova etapa Optimizing images mostra o progresso ao vivo no dashboard e na CLI durante cada build. Conversão automática de imagens →
Playground de API. As páginas de endpoints agora têm um "Try it" button interativo. Preencha os parâmetros, veja os exemplos de código serem atualizados em tempo real e envie solicitações reais sem sair da documentação. Ativado por padrão em todas as páginas de API. Funciona com endpoints OpenAPI e endpoints escritos em MDX.
Plugin Claude Code. Instale o plugin do Jamdesk para Claude Code para dar ao Claude conhecimento detalhado sobre componentes MDX, configuração de docs.json, padrões de navegação e comandos da CLI. Instalação em duas etapas pelo marketplace de plugins. Combina com CLAUDE.md e o servidor MCP para escrita de documentação assistida por IA.
Avisos de build para branding ausente. Os builds agora avisam quando os caminhos de favicon ou logo no docs.json apontam para arquivos inexistentes no projeto. Os avisos aparecem nos detalhes do build no dashboard e na CLI por meio de jamdesk dev e jamdesk validate. Nenhum e-mail é enviado; o aviso é apenas informativo.
YouTube Shorts. O <YouTube> component oferece suporte a Shorts verticais por meio da prop short, renderizando um player centralizado em 9:16 sem barras pretas. Use <YouTube id="VIDEO_ID" short />.
Menu AI Actions. Um dropdown em todas as páginas permite que os leitores copiem Markdown, abram a página no ChatGPT/Claude/Perplexity, obtenham a configuração do servidor MCP ou façam uma instalação com um clique no Cursor ou VS Code. Ativado por padrão; escolha quais opções aparecem usando contextual no docs.json.
Análise. Análise de páginas sem cookies, acompanhando visualizações, origens de tráfego e tendências de visitantes, com detalhamento por página. Nenhum banner de consentimento é necessário. Visão geral: Análise.
Integrações. Google Analytics 4, Google Tag Manager, Plausible Analytics e notificações de build do Slack (Pro).
Feed RSS para changelogs. Páginas com rss: true no frontmatter agora geram automaticamente um feed RSS assinável. Um ícone RSS aparece ao lado do título da página, e um feed.xml é criado a partir dos componentes Update durante cada build. Use a nova prop date em Update para obter datas corretas no feed.
Login e deploy pela CLI. jamdesk login autentica pelo navegador. jamdesk deploy empacota seu projeto e inicia um build pelo terminal. Não é necessária conexão com o GitHub. A CLI respeita .gitignore, avisa sobre arquivos secretos e transmite o progresso do build inline.
Verificação ortográfica na CLI. jamdesk spellcheck verifica erros ortográficos na documentação usando mais de 180 termos técnicos integrados (somente em inglês). jamdesk spellcheck --fix inicia um modo interativo para corrigir erros de digitação ou adicionar palavras à lista de ignorados.
Incorporações de vídeo. Incorpore arquivos .mp4 e .webm diretamente na documentação. Coloque-os em um diretório /videos e use a sintaxe Markdown (<Video src="/_jd/videos/demo.mp4?v=mwdojjfh" title="Demo" />) ou o <Video> component para reprodução automática, loop e outros controles.
JavaScript personalizado. Adicione scripts do lado do cliente para widgets de chat, análise ou integrações de terceiros por meio de styling.js no docs.json.
Chat de IA. Assistente de chat integrado em todos os sites de documentação. Os visitantes fazem perguntas e recebem respostas com links de citação para as páginas de origem. Desenvolvido com Claude e ativado em todos os planos.
Integração com IA. Cada site gera llms.txt para janelas de contexto de LLM, disponibiliza Markdown bruto em URLs .md e inclui um servidor MCP em /_mcp, com as ferramentas searchDocs e getPage. Guias de configuração para Claude Code, Cursor e Codex. Também: Escrever com IA e Atualizações automatizadas.
CLI. jamdesk dev para visualização local com hot reload, jamdesk validate para links quebrados, jamdesk migrate para converter de Mintlify/GitBook/Docusaurus e jamdesk doctor para problemas de configuração. Instale via npm, curl ou Homebrew. Referência completa →
Extensão do VS Code. Inicie, pare e reinicie o servidor de desenvolvimento pela barra de status do VS Code, sem necessidade de terminal.
Verificação TXT de domínio personalizado. Todos os domínios personalizados agora exigem um registro TXT (_jamdesk.yourdomain.com) antes da ativação do roteamento. Isso impede a tomada de domínios em subdomínios não reivindicados. Domínios adicionados recentemente exibem o registro TXT no fluxo de configuração do dashboard. Consulte o guia de domínios personalizados.
Suporte multilíngue. Defina árvores de navegação e diretórios de conteúdo separados por localidade. Os leitores trocam de idioma em um dropdown na barra superior.
Análise de busca. O que os leitores pesquisam, quais consultas não retornam resultados e quais resultados realmente recebem cliques. Útil para encontrar lacunas de conteúdo.
O Jamdesk é lançado. Escreva documentação em MDX, faça push para o GitHub e obtenha um site em uma CDN global. Os builds terminam em menos de 60 segundos.
MDX e componentes. Mais de 20 componentes integrados: abas, acordeões, etapas, grupos de código, diagramas Mermaid, matemática KaTeX e ícones. Destaque de sintaxe com números de linha em blocos de código. Crie componentes React personalizados com Tailwind e hooks e reutilize conteúdo com snippets. Visão geral dos componentes →
Documentação OpenAPI. Gere páginas de referência de API a partir da sua especificação OpenAPI usando api.openapi no docs.json.
Deploy. Deploy automático pelo GitHub a cada push, com debounce de 10 segundos. Domínios personalizados com SSL automático, hospedagem em subcaminho em /docs (Vercel, CloudFront, Cloudflare, nginx) e suporte a monorepos.
Personalização. Três temas (jam, nebula, pulsar) com cores, logotipos e rodapé personalizados. CSS personalizado para substituir estilos. Navegação flexível com abas, grupos e ícones. Redirecionamentos com correspondência exata e por curingas.
Busca e SEO. Busca de texto completo com Cmd+K, sem configuração. Sitemaps, imagens OG e metadados por página prontos para uso.
Referência de docs.json. Referência completa de configuração para todas as definições e opções.
Central de ajuda. Guias de gerenciamento de conta, faturamento e solução de problemas.
