Supported Formats

Airmailer supports multiple document formats to make it easy to import your existing content. Understanding each format helps you choose the best option for your documents.

Format Comparison

| Format | File Extension | Formatting | Best Use Case | |--------|---------------|------------|---------------| | Markdown | .md | Full | New documents, structured content | | HTML | .html | Converted | Website exports, existing web pages | | Plain Text | .txt | None | Simple content, quick notes |

Markdown (.md)

Markdown is the recommended format for Airmailer documents.

Why Markdown?

• Preserves structure: Headings, lists, and formatting work perfectly
• Human readable: Easy to create and edit
• Best AI comprehension: Structure helps the agent understand content

Supported Markdown Features

# Heading 1
## Heading 2
### Heading 3

**Bold text** and *italic text*

- Bullet list item 1
- Bullet list item 2

1. Numbered list item 1
2. Numbered list item 2

[Link text](https://example.com)

> Blockquote text

`inline code`

| Table | Headers |
|-------|---------|
| Cell  | Cell    |

Creating Markdown

You can create Markdown files with:

• Any text editor (VS Code, Sublime, Notepad)
• Markdown editors (Typora, iA Writer, Obsidian)
• Export from Google Docs (with add-ons)
• Export from Notion

HTML (.html)

HTML files are automatically processed and converted to Markdown.

HTML Processing

When you upload HTML, Airmailer:

1. Identifies the main content using semantic HTML
2. Removes boilerplate (navigation, footer, ads)
3. Converts to Markdown preserving structure
4. Cleans formatting for optimal AI use

What's Preserved

• Headings (<h1> through <h6>)
• Paragraphs (<p>)
• Lists (<ul>, <ol>, <li>)
• Links (<a>)
• Bold (<strong>, <b>)
• Italic (<em>, <i>)
• Tables (<table>)
• Blockquotes (<blockquote>)

What's Removed

• Navigation menus
• Header/footer elements
• Sidebar content
• Scripts and styles
• Advertisements
• Comments

Getting HTML from Your Website

Option 1: Save Page As

1. Open the webpage in your browser
2. Right-click → Save As
3. Choose "Webpage, HTML Only"
4. Upload the saved file

Option 2: Copy Source

1. View page source (Ctrl/Cmd + U)
2. Select all and copy
3. Paste into a new .html file
4. Upload the file

Option 3: Developer Tools

1. Open Developer Tools (F12)
2. Find the main content element
3. Copy the HTML
4. Save and upload

Plain Text (.txt)

Plain text is the simplest format with no formatting preserved.

When to Use Plain Text

• Quick notes or simple content
• Content without structure needs
• Direct text exports from other systems

Limitations

• No headings or hierarchy
• No bold or italic
• No lists (appear as plain lines)
• No links (URL only, no anchor text)

Improving Plain Text Documents

To make plain text more useful, structure it with clear markers:

RETURN POLICY

Timeframe:
Returns accepted within 30 days of purchase.

Conditions:
- Items must be unused
- Original packaging required
- Receipt must be included

Process:
1. Contact customer service
2. Receive return authorization
3. Ship item back
4. Refund processed in 5-7 days

Format Recommendations

For New Content

Use Markdown. It's easy to write and provides the best results.

For Existing Web Pages

Use HTML or URL ingestion. Both work well for importing web content.

For Quick Additions

Plain text works for simple, short content that doesn't need formatting.

Character Encoding

All documents should use UTF-8 encoding. This ensures:

• International characters display correctly
• Emojis work (if needed)
• No encoding errors during processing

Checking Encoding

Most modern text editors use UTF-8 by default. If you have issues:

• Save as UTF-8 explicitly
• Use "Save with Encoding" option
• Avoid legacy encodings (ASCII, ANSI, Latin-1)

File Size Considerations

| Size | Recommendation | |------|----------------| | Under 100 KB | Ideal | | 100 KB - 500 KB | Good | | 500 KB - 2 MB | Consider splitting | | Over 2 MB | Split into multiple documents |

Smaller, focused documents typically perform better than large, general ones.

Next Steps

• Upload your documents
• Import from URLs
• Understand document overview