File formats
Knowledge reads five file formats. Each is turned into text with headings and lists, which is what Pip reads.
| Format | Extension | What is kept | Best for |
|---|---|---|---|
| Markdown | .md | Everything | New documents, structured text |
| Word | .docx | Headings, lists, paragraphs, tables | Documents written in Word or Google Docs |
.pdf | Text only | Policies and guides you already have | |
| HTML | .html | Main content, headings, lists, links, tables | Saved web pages |
| Plain text | .txt | Text only | Short notes |
Markdown
Markdown keeps the structure of a document exactly, which helps Pip find the right passage.
# Returns
## Deadline
Returns are accepted within 30 days of delivery.
## Condition
- Unused
- In the original packaging
[Start a return](https://yourshop.com/returns)
Any text editor can write Markdown, and Notion and many other apps export it.
HTML
The main content of an HTML file is kept and turned into headings, lists, links and tables. Navigation, headers, footers, scripts and styles are removed.
To save a web page as HTML, open it in your browser and choose Save page as, then Webpage, HTML only. Adding the page by its address is usually easier: see Adding web pages.
Plain text
Plain text has no headings or formatting. Mark the structure with clear lines instead:
RETURNS
Deadline:
Returns are accepted within 30 days of delivery.
Condition:
- Unused
- In the original packaging
Character encoding
Save text, Markdown and HTML files as UTF-8 so accented characters read correctly. Most editors do this by default.
File size
Files can be up to 4 MB. Shorter documents about one topic work better than one long document about everything.