Cookie consent

This website uses cookies. By agreeing to all of them, you accept their use for marketing, personalising advertising content, analysing website traffic and other activities related to running our business. You can find detailed information about cookies in our privacy policy.

Skip to content
ENPL
Log in

Writing articles manually

How to write knowledge base articles in the Fibly editor, in visual or source mode.

When you want to add a topic that isn't in the base yet, use Fibly's built-in editor. By default it works in visual (WYSIWYG) mode, so you don't need to know Markdown to format text. If you prefer, you can switch it to source mode at any time.

Creating a new article

  1. Go to the Documentation tab.
  2. Click Add article.
  3. Enter a title, optionally a short description, and choose whether the article should be visible to the bot right away.
  4. Write the content in the editor.
  5. Click Save.

Visual mode (default)

In visual mode you see the formatted text as it will look after saving. Above the editing field is a toolbar with buttons for the most common operations:

  • bold, italic, strikethrough,
  • first-, second-, and third-level headings,
  • bulleted and numbered lists,
  • quote, inline code, and code block,
  • link, table, horizontal rule,
  • undo and redo.

Keyboard shortcuts also work, e.g. Ctrl + B for bold, Ctrl + I for italic.

Source mode

If you prefer to write directly in Markdown, switch the editor to source mode with the </> icon in the top right corner of the toolbar. You'll then see the raw Markdown text and can edit it by hand. You return to visual mode with the same button.

Source mode is usually handy for pasting larger chunks of text copied from another tool, or for small formatting fixes the toolbar doesn't cover.

Limits and guidelines

  • Maximum article length: 20,000 characters.
  • Maximum length of a pinned article: 1,500 characters (see Pinning).
  • Fibly will flag articles under roughly 50 words as Too short, and the bot won't use them.

What's worth writing manually

Topics that rarely make it onto your public website but come up often in customer conversations:

  • the returns process, step by step,
  • the complaints procedure and typical waiting periods,
  • product specifications beyond what's on the product page,
  • answers to the questions you get most often by email or chat.

What's next

Once you've gathered a few articles on related topics, link them with prerequisites so the bot reads them together and keeps the context.