Skip to main content
The quality of your chat’s responses doesn’t depend only on how much information you provide. The way that information is organized also matters. While Attlas can process many different types of content, well-structured information tends to produce clearer, more accurate, and more consistent responses. For this reason, whenever possible, we recommend organizing your content using a structure similar to Markdown.

​
What is Markdown?

Markdown is a simple way to structure content using headings, subheadings, lists, and clearly organized sections. It is widely used in documentation, knowledge bases, and AI systems because it helps preserve the hierarchy of information. Even when you upload PDFs, Word documents, or plain text, Attlas attempts to identify and understand this structure automatically. The more organized the structure is, the better.

​
Common Markdown Syntax

Here is a quick reference of the most common Markdown formatting elements that you can use to structure your documents:

​
Why is structure important?

AI doesn’t just read words. It also tries to understand:
  • What is a heading;
  • What is a subheading;
  • Which information belongs to each section;
  • How topics are related;
  • What represents a list;
  • What is a question and what is an answer.
When information is well organized, Attlas can better understand context and retrieve information more accurately.

​
Use headings and subheadings

One of the best practices is dividing content into clear sections.

​
Poor Example

​
Better Example

The second version creates a much clearer hierarchy for AI to interpret.

​
Use lists whenever possible

Lists help separate concepts and reduce ambiguity.

​
Example

Product benefits:
  • Easy implementation
  • CRM integration
  • Dedicated support
  • Advanced reporting
This is often easier to interpret than a large block of text.
Avoid mixing completely unrelated topics within the same document.

​
Avoid

  • Product information;
  • Internal policies;
  • Recipes;
  • Company information;
All combined into a single file.

​
Prefer

One document for each major topic. This helps Attlas understand the context more effectively.

​
Use question-and-answer format for FAQs

When creating help centers or FAQ content, use a clear question-and-answer structure.

​
Example

​
How do I request a refund?

You can request a refund through your customer portal.

​
What is the delivery time?

The average delivery time is five business days.
This format makes it easier for Attlas to retrieve answers when users ask similar questions.

​
Avoid redundant or conflicting information

One of the most common causes of inconsistent answers is conflicting content.

​
Example

Document A:
Our company has been in business for 20 years.
Document B:
Our company has been operating for 22 years.
When this happens, Attlas may struggle to determine which information is the most up to date. Whenever possible:
  • Update older documents;
  • Remove duplicate content;
  • Maintain a single source of truth for important information.

Attlas Best Practices Guide

Learn more about content consistency and quality in our Attlas Best Practices Guide.

​
Better structure means better understanding

Attlas can process content from many different formats. However, when information is organized using headings, subheadings, lists, and clearly defined sections, understanding becomes much more effective. Think of content structure as a map. The easier it is for AI to navigate your information, the better the responses it can deliver. Good structure does not replace good content. But good content combined with good structure almost always produces better results.
Last modified on June 25, 2026