Durante anos, abrir um arquivo .md no SharePoint era uma experiência desconfortável: texto puro, sem formatação, sem graça. Se você quisesse ver algo decente, precisava baixar o arquivo e abrir em outro lugar. Em abril de 2026, isso mudou de vez. A Microsoft anunciou suporte nativo ao Markdown, com editor visual, prévia em tempo real e, o mais interessante, um papel novo como formato de memória para os agentes de IA dentro do SharePoint.
Parece perfeito. E em boa parte é. Mas como toda função recém-saída do forno, vale analisá-la com olho crítico antes de apostar processos críticos do negócio nela.
O arquivo que parou de se esconder
O editor novo tem três modos: visualização, edição e split, com o código-fonte de um lado e o resultado renderizado do outro, atualizando em tempo real. Cabeçalhos, listas, tabelas, checkboxes, blocos de código com destaque de sintaxe: tudo isso agora aparece corretamente, sem precisar decorar a sintaxe graças a uma barra de formatação.
Os arquivos .md também deixaram de ser cidadãos de segunda classe. São criados pelo mesmo botão que qualquer outro arquivo, filtrados por tipo, e herdam versionamento, permissões e toda a governança que qualquer documento já tinha no SharePoint ou no OneDrive.
O caderno que o agente não te mostrava
Aqui está o verdadeiro motivo por trás do lançamento. A Microsoft está usando Markdown como formato de armazenamento para a memória dos agentes de IA no SharePoint. Existe agora uma biblioteca nova, a Agents Assets library, onde ficam salvas as preferências do time e as "skills" que um agente pode aprender e compartilhar. É a primeira vez que o time pode literalmente abrir um arquivo e ler o que a IA lembra sobre o site.
É uma ideia sólida: a memória de um agente deixou de ser uma caixa-preta e virou um arquivo de texto plano, auditável, versionado, editável por humanos. Para quem está pensando em governança de IA dentro do Microsoft 365, essa é exatamente a direção certa.
Onde o brilho apaga
É aqui que freamos o entusiasmo.
Os agentes do Copilot Studio ainda não leem bem esses arquivos. Se você salva .md em uma biblioteca do SharePoint e a usa como knowledge source para um agente de Copilot Studio, há relatos de que esse conteúdo não é recuperável nem citável pelo agente. Não é um detalhe pequeno: significa que a documentação técnica que você guarda em Markdown pode ser invisível para o mesmo Copilot que deveria usá-la.
As "skills" de IA no SharePoint ainda estão em preview, e isso aparece. O agente não pode chamar sistemas externos nem executar código próprio, não consegue ler permissões nem dados de compartilhamento, e nem cria uma tarefa no Planner sem um workaround via Power Automate. O editor de Markdown e os controles de governança, segundo quem testou a fundo, ainda precisam de trabalho.
O renderizado avançado tem limite. Tabelas aninhadas, extensões como notas de rodapé ou diagramas: não espere que se comportem como no GitHub ou em um editor dedicado. Para documentação simples funciona muito bem. Para documentação complexa, você vai bater no teto.
O teste antes da promessa
Markdown no SharePoint já é production-ready para salvar e editar texto. Ainda não é production-ready como fonte de verdade para um agente raciocinar sobre ela.
Se você está pensando em migrar documentação técnica, runbooks ou ADRs para Markdown dentro do SharePoint: faça, a experiência de leitura e edição melhorou muito e vale a pena. Se está pensando em usar esses mesmos arquivos como base de conhecimento para um agente de Copilot Studio que um cliente vai usar em produção: teste primeiro, em pequena escala, antes de prometer. A promessa de "a IA lê sua documentação em Markdown" ainda tem uma letra miúda que vale ler duas vezes.
O ponto
A Microsoft acaba de dar um passo importante: tratar Markdown como cidadão de primeira classe dentro do ecossistema Microsoft 365. A direção é certa, especialmente pensando em como vai se construir a memória dos agentes nos próximos anos. Mas a distância entre "aparece bem no navegador" e "um agente pode confiar nesse conteúdo para responder" ainda é real. Se você trabalha com IA dentro do SharePoint, essa distância é exatamente o que você precisa medir antes de construir qualquer coisa em cima.
Se você quer acompanhar esse tipo de novidade antes de chegar na imprensa em geral, assine a newsletter da macareno.net.
Fontes
- Introducing Markdown support in SharePoint and OneDrive — Microsoft Community Hub
- Native Markdown Editing now in OneDrive and SharePoint — Office Watch
- SharePoint AI Skills: What Works & Fails — HubSite365
- Copilot Studio + SharePoint: Markdown (.md) Files in Doc Libraries Supported as Knowledge Sources? — Microsoft Community Hub