# Guia: Markdown para Agentes (MFA)

Como estruturar arquivos Markdown que servem de "diretório raiz" para a compreensão de agentes autônomos de IA.

## 1. O Conceito MFA
Agentes de IA preferem processar Markdown devido à alta densidade de informação e baixa verbosidade técnica em comparação ao HTML/JS.

## 2. Estrutura do Arquivo MFA ideal
- **H1:** Título claro do recurso.
- **Resumo:** 2-3 frases definindo o propósito da página.
- **Listas:** Use listas para parâmetros técnicos ou passos.
- **Código:** Blocos de código `json` ou `javascript` para integração direta.

## 3. Linkagem para Agentes
Sempre linke para as fontes de dados brutas (`.json` ou outros `.md`) para que o agente possa navegar recursivamente pela sua infraestrutura.

## 4. Onde Hospedar?
- `/llms.txt` na raiz.
- `/agents/` diretório dedicado.
- Linkar via `<link rel="alternate" type="text/markdown">` no HTML.

---
© 2026 geodata.ia.br - Especialistas em GEO