Import Markdown files

If you keep your documentation in a tool that exports .md files (e.g. GitBook, Docusaurus, Notion, Outline), you can move it into Fibly in a few clicks.

Step 1: prepare the files

Export your documentation to .md files. Each file becomes a single article in the knowledge base. We recommend that you:

• use short, clear file names, since they will become the article titles,
• remove metadata specific to your old tool from the files (e.g. custom shortcodes),
• keep standard Markdown syntax (# headings, lists, links, code blocks).

Step 2: run the import in the panel

1. Go to the Documentation tab.
2. Click Import in the top right corner.
3. Drag your .md files into the import window or pick them through the file browser.
4. Confirm with Import selected.

Limits

• a maximum of 50 files per import,
• a maximum of 20,000 characters of content in a single article (split longer files into smaller ones before importing).

Import statuses

During import, each file ends up in one of these states:

• Created: a new article was created in the knowledge base.
• Updated: an article with the same name already existed, and its content was replaced.
• Unchanged: an existing article had identical content.
• Skipped: Fibly couldn't parse the file (usually an invalid format).

After the import

Open a few of the imported articles at random and check that they kept their formatting. If something needs fixing, edit it directly in the panel (see Write articles manually).

What's next

Think about which of the imported articles are worth pinning. Those are the ones that will have the biggest impact on the bot's answers.