mdman

01 · O briefing

Documentação que não apodrece.

O mdman é um editor de Markdown para equipas técnicas. Os documentos continuam em Markdown simples, o chat com IA responde com base no documento que está a ler, os diagramas Mermaid aparecem no próprio texto, cada alteração fica guardada no histórico e um espaço de trabalho pode ser publicado como blog num domínio próprio.

O público, programadores, redatores técnicos e equipas de produto, já viu todas as ferramentas de documentação prometerem resolver a wiki e acabarem por ser mais uma wiki. É alérgico a marketing e lê as letras pequenas: dependência de fornecedor, privacidade e para onde vão as suas chaves.

02 · O que a página tinha de fazer

Ganhar a confiança de quem detesta páginas de marketing.

A página tinha de convencer um programador a experimentar o mdman numa só visita. Para isso, tinha de:

• Dizer numa frase o que é o mdman e em que é diferente das wikis que as equipas já usam.
• Mostrar abrangência sem excessos: muitas capacidades, todas claramente úteis.
• Responder logo às questões de confiança: portabilidade, alojamento próprio, encriptação e a possibilidade de usar a própria chave de IA.
• Ajudar equipas diferentes a reconhecer o seu caso de uso.
• Manter o caminho até ao primeiro documento gratuito e sem atrito.

03 · Como resolvemos

Escrito na língua de quem lê.

Os textos são curtos, secos e específicos, como os programadores escrevem entre si: «Docs that don't rot.» «Nine features. No bloat. Each one earns its keep.» As afirmações são concretas, como os diagramas Mermaid gerados ao guardar, o autosave em cada tecla e os alertas de edição enviados pelo servidor, sem polling, porque é isso que este público verifica.

O design segue a mesma lógica: escuro por defeito, um único destaque laranja, uma só sem serifa e muito espaço. Nove funcionalidades aparecem numa grelha fácil de percorrer e, a seguir, secções mais longas explicam a edição («Markdown in. Rendered out.»), os diagramas como código, o chat com IA usando a sua chave Gemini e a publicação de um espaço de trabalho num domínio próprio, com temas, TLS e metadados para pesquisa tratados.

A confiança é tratada onde a pergunta surge: exportação em Markdown simples, uma plataforma que pode ser alojada internamente, encriptação em trânsito e em repouso, e IA que corre com a sua chave. Uma matriz «um editor, seis trabalhos», da documentação de APIs e blogs de engenharia a RFCs, wikis internas, atas e roadmaps, ajuda cada equipa a encontrar a sua razão para começar, e sete perguntas frequentes respondem às dúvidas sobre comparações e preços.

04 · Feito para ser encontrado

Pronto para a pesquisa e para as respostas de IA.

Dados estruturados de aplicação e de perguntas frequentes descrevem o produto e as suas respostas aos motores de pesquisa, um ficheiro llms.txt resume-o para os assistentes de IA e um blog prepara o terreno para um programa de conteúdos. O desenvolvimento em Next.js está alojado na Vercel.

05 · O que entregámos

Os entregáveis.

• Posicionamento e textos da página
• Design escuro, pensado para o teclado
• Arquitetura de funcionalidades, casos de uso e perguntas frequentes
• Blog
• Dados estruturados, sitemap e llms.txt
• Desenvolvimento em Next.js, alojado na Vercel