Import plików Markdown

Jak zaimportować istniejącą dokumentację w formacie Markdown do bazy wiedzy Fibly.

Jeśli prowadzisz dokumentację w narzędziu, które eksportuje pliki .md (np. GitBook, Docusaurus, Notion, Outline), możesz przenieść ją do Fibly w kilku kliknięciach.

Krok 1: przygotuj pliki

Wyeksportuj dokumentację do plików .md. Każdy plik staje się jednym artykułem w bazie wiedzy. Zalecamy:

  • używać krótkich, jasnych nazw plików, ponieważ staną się tytułami artykułów,
  • usunąć z plików metadane specyficzne dla starego narzędzia (np. niestandardowe shortcode'y),
  • zachować standardową składnię Markdown (nagłówki #, listy, linki, bloki kodu).

Krok 2: uruchom import w panelu

  1. Przejdź do zakładki Dokumentacja.
  2. Kliknij Importuj w prawym górnym rogu.
  3. Przeciągnij pliki .md do okna importu lub wybierz je przez eksplorator.
  4. Potwierdź Importuj wybrane.

Limity

  • maksymalnie 50 plików na jeden import,
  • maksymalnie 20 000 znaków treści w pojedynczym artykule (dłuższe pliki podziel na mniejsze przed importem).

Statusy importu

Każdy plik podczas importu trafia w jeden ze stanów:

  • Utworzony: nowy artykuł powstał w bazie wiedzy.
  • Zaktualizowany: artykuł o tej samej nazwie istniał, treść została podmieniona.
  • Bez zmian: istniejący artykuł miał identyczną treść.
  • Pominięty: Fibly nie był w stanie sparsować pliku (zwykle niepoprawny format).

Po imporcie

Otwórz losowo kilka zaimportowanych artykułów i sprawdź, czy zachowały formatowanie. Jeśli coś wymaga poprawki, edytuj bezpośrednio w panelu (zob. Ręczne pisanie artykułów).

Co dalej

Zastanów się, które z zaimportowanych artykułów warto przypiąć. To one będą miały największy wpływ na odpowiedzi bota.