docmd

O que o docmd é de fato

docmd (github.com/docmd-io/docmd) é uma CLI Node que transforma uma pasta de Markdown em um site de documentação. `npx @docmd/core dev` roda em qualquer pasta que tenha Markdown e serve em localhost sem arquivo de configuração, sem exigir frontmatter e com a navegação derivada da sua estrutura de diretórios; `npx @docmd/core build` grava um site estático que você hospeda onde quiser. A licença é um MIT simples no arquivo LICENSE do repositório, o projeto começou em maio de 2025 e o histórico de versões é constante em vez de aos solavancos — da 0.8.15 em 15 de julho de 2026 até a 0.9.4 em 23 de agosto de 2026, com 14 issues abertas no momento da captura.

• Começa sem nada configurado Nenhum arquivo de configuração é necessário. Existe um `docmd.config.json` para quando você quiser definir um título, uma URL canônica ou diretórios de origem e saída diferentes, e ele pode ser escrito em TypeScript ou JavaScript quando precisar de valores dinâmicos.
• Os artefatos para IA são plugins do núcleo, não extras Os plugins `llms`, `okf`, `search`, `seo` e `sitemap` já vêm ativados, então os arquivos de contexto e o sitemap saem de um build comum e não de um passo que alguém precisa lembrar.
• A migração já vem na caixa `docmd migrate` converte uma instalação existente de Docusaurus, VitePress, MkDocs ou Starlight, o que importa principalmente porque significa que testar não começa com uma reescrita.
• Trata idiomas e versões como builds de primeira classe Builds multi-idioma produzem um índice de busca por idioma, arquivos de contexto por idioma e tags hreflang, e as versões da documentação são nativas em vez de plugin. Se você já traduz seu site, é esta a parte que decide se serve.
• Confira a versão do Node no pacote, não no README O README diz Node.js 18 ou superior; o pacote publicado `@docmd/core` declara `engines.node >= 20.0.0`. Em uma máquina ainda na 18, quem vai te avisar é a instalação, então conte com a 20.

Existe também um lado hospedado, e vale saber onde fica a linha antes de adotar. O plugin de assistente de IA faz chat com recuperação sobre a sua própria documentação usando a sua chave de API ou um modelo local; o Cloud Relay em cloud.docmd.io existe para que um site puramente estático rode esse assistente sem você subir um backend. O compilador e todos os artefatos abaixo estão no repositório MIT — o relay é a conveniência hospedada opcional, que é a forma open core em miniatura.

Os quatro artefatos para máquinas, e o que consome cada um

É por isso que essa lista vale mais do que parece. Publicamos `llms.txt` e `llms-full.txt` para a AgentCeres — a Diretoria de Crescimento com IA, em agentceres.com — e escrevemos os dois à mão. Eles desviaram. Os arquivos listavam papéis internos que um cliente não consegue selecionar e uma tabela de preços por assento descrevendo um modelo que nunca vendemos. Ninguém percebeu por semanas, porque as verificações que protegem nosso texto de marketing varrem os diretórios de código da aplicação, e esses dois arquivos ficam em uma pasta estática `public/` que nenhuma delas lê. Um arquivo de contexto gerado elimina essa classe inteira de erro por construção — não porque gerar seja mais inteligente, mas porque não sobra uma segunda cópia para ficar desatualizada.

Onde ele entra quando você quer ser encontrado

Documentação é uma das poucas coisas que um time pequeno escreve e que um motor de respostas consegue usar diretamente: é específica, é datada e descreve um produto que mais ninguém descreve com essa precisão. Isso faz dela boa matéria-prima para a otimização para motores generativos, e o docmd derruba para perto de zero o custo de torná-la recuperável. Se a sua pergunta é a mais ampla de como fazer o ChatGPT citar a sua startup, isto é uma entrada desse problema, não a resposta dele.

Seja claro sobre o limite, porque é fácil superestimar. Emitir um arquivo de contexto barateia a recuperação da sua documentação; não faz um modelo escolher você, e nenhum passo de build faz. E cobre só a documentação. Sua página de preços, suas páginas de comparação e suas landing pages são outro corpus com outros problemas, e normalmente são elas que recebem de fato a pergunta de quem compra. Se o que você precisa é de um site de documentação e não da metade legível por máquina, o Docusaurus é a escolha mais convencional e está coberto separadamente.

A ordem honesta para quem tem uma startup: escreva a documentação porque seus usuários precisam dela, fique com os arquivos de contexto como subproduto gratuito e trate o tráfego como um efeito de segunda ordem que pode levar meses para aparecer. Publicar os arquivos é uma flag de build. Merecer a citação é o trabalho, e essa parte continua sendo escrever — que é onde a AgentCeres redige junto com você e uma pessoa aprova tudo o que sai.