Qu’est-ce que Markdown ?
Markdown est un moyen simple de structurer le contenu à l’aide de titres, de sous-titres, de listes et de sections clairement organisées. Il est largement utilisé dans la documentation, les bases de connaissances et les systèmes d’IA, car il aide à préserver la hiérarchie des informations. Même lorsque vous téléversez des PDF, des documents Word ou du texte brut, Attlas tente d’identifier et de comprendre automatiquement cette structure. Plus la structure est organisée, mieux c’est.Syntaxe Markdown courante
Voici un aide-mémoire des éléments de formatage Markdown les plus courants que vous pouvez utiliser pour structurer vos documents :Pourquoi la structure est-elle importante ?
L’IA ne se contente pas de lire les mots. Elle essaie également de comprendre :- Ce qui constitue un titre ;
- Ce qui constitue un sous-titre ;
- Quelles informations appartiennent à chaque section ;
- Comment les sujets sont liés ;
- Ce qui représente une liste ;
- Ce qui constitue une question et ce qui constitue une réponse.
Utilisez des titres et des sous-titres
L’une des bonnes pratiques consiste à diviser le contenu en sections claires.Mauvais exemple
- Exemple
- Résultat
Meilleur exemple
- Exemple
- Résultat
Utilisez des listes dès que possible
Les listes aident à séparer les concepts et à réduire l’ambiguïté.Exemple
Avantages du produit :
- Mise en œuvre facile
- Intégration CRM
- Support dédié
- Rapports avancés
Regroupez les informations connexes
Évitez de mélanger des sujets totalement différents dans le même document.À éviter
- Informations sur le produit ;
- Politiques internes ;
- Recettes ;
- Informations sur l’entreprise ;
À privilégier
Un document pour chaque sujet principal. Cela aide Attlas à comprendre le contexte de manière plus efficace.Utilisez un format de questions-réponses pour les FAQ
Lors de la création de centres d’aide ou de contenu FAQ, utilisez une structure claire de questions-réponses.Exemple
Ce format permet à Attlas de retrouver plus facilement les réponses lorsque les utilisateurs posent des questions similaires.
Évitez les informations redondantes ou contradictoires
L’une des causes les plus fréquentes de réponses incohérentes est un contenu contradictoire.Exemple
Document A :Notre entreprise existe depuis 20 ans.Document B :
Notre entreprise fonctionne depuis 22 ans.Lorsque cela se produit, Attlas peut avoir du mal à déterminer quelle information est la plus à jour. Dans la mesure du possible :
- Mettez à jour les anciens documents ;
- Supprimez le contenu en double ;
- Conservez une source unique de vérité pour les informations importantes.
Guide des bonnes pratiques d'Attlas
Apprenez-en plus sur la cohérence et la qualité du contenu dans notre Guide des bonnes pratiques d’Attlas.

