Skip to content
ENPL
Log in

Import Markdown files

How to import existing documentation in Markdown format into the Fibly knowledge base.

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. Fibly takes the article title from the title field in the file's YAML front matter, if there is one; otherwise from the first # heading; and only if neither exists, from the file name. We recommend that you:

  • give each file a clear # heading or a short, clear file name,
  • 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 Knowledge base tab and open the knowledge base you want to import into.
  2. Click Import articles above the article list.
  3. Drag your .md files into the import window or pick them through the file browser. You can also drag in whole folders; Fibly picks up every .md file inside them.
  4. Confirm with Import.

Limits

  • a maximum of 250 files per import,
  • only .md files are accepted,
  • a maximum of 20,480 characters of content in a single article. Longer files are skipped, so split them 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 title 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), or the file was longer than the article limit.

Past imports and the status of each file are listed under Import history below the article list.

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.