O que é Markdown?
Markdown é uma maneira simples de estruturar conteúdo usando títulos, subtítulos, listas e seções claramente organizadas. Ele é amplamente utilizado em documentações, bases de conhecimento e sistemas de IA porque ajuda a preservar a hierarquia das informações. Mesmo quando você faz upload de PDFs, documentos do Word ou texto simples, o Attlas tenta identificar e entender essa estrutura automaticamente. Quanto mais organizada for a estrutura, melhor.Sintaxe Markdown comum
Aqui está uma referência rápida dos elementos de formatação Markdown mais comuns que você pode usar para estruturar seus documentos:Por que a estrutura é importante?
A IA não lê apenas palavras. Ela também tenta entender:- O que é um título;
- O que é um subtítulo;
- Qual informação pertence a cada seção;
- Como os tópicos se relacionam;
- O que representa uma lista;
- O que é uma pergunta e o que é uma resposta.
Use títulos e subtítulos
Uma das melhores práticas é dividir o conteúdo em seções claras.Exemplo Ruim
- Exemplo
- Resultado
Exemplo Melhor
- Exemplo
- Resultado
Use listas sempre que possível
Listas ajudam a separar conceitos e reduzir ambiguidades.Exemplo
Benefícios do produto:
- Implementação fácil
- Integração com CRM
- Suporte dedicado
- Relatórios avançados
Agrupe informações relacionadas
Evite misturar tópicos completamente diferentes no mesmo documento.Evite
- Informações do produto;
- Políticas internas;
- Receitas culinárias;
- Informações da empresa;
Prefira
Um documento para cada tópico principal. Isso ajuda o Attlas a entender o contexto de forma mais eficaz.Use o formato de pergunta e resposta para FAQs
Ao criar centrais de ajuda ou conteúdo de FAQ, utilize uma estrutura clara de pergunta e resposta.Exemplo
Esse formato facilita para o Attlas recuperar respostas quando os usuários fazem perguntas similares.
Evite informações redundantes ou conflitantes
Uma das causas mais comuns de respostas inconsistentes é o conteúdo conflitante.Exemplo
Documento A:Nossa empresa está no mercado há 20 anos.Documento B:
Nossa empresa está operando há 22 anos.Quando isso acontece, o Attlas pode ter dificuldade para determinar qual informação é a mais atualizada. Sempre que possível:
- Atualize documentos mais antigos;
- Remova conteúdo duplicado;
- Mantenha uma única fonte de verdade para informações importantes.
Guia de Boas Práticas do Attlas
Saiba mais sobre consistência e qualidade de conteúdo em nosso Guia de Boas Práticas do Attlas.