Fibel

Fibel liest Markdown aus einem Content-Verzeichnis und liefert es als Website aus. Die Quelldateien bleiben im Repository lesbar, und jede Seite steht zusätzlich als rohes Markdown bereit. Reviewer, Skripte und Sprachmodelle arbeiten damit auf derselben Quelle, aus der die Website gebaut wird.

Sämtliche eingebauten Funktionen sind Plugins: Markdown-Rendering, Layout, Suche, Theme-Handling, i18n-Prüfung und SEO-Ausgabe. Das Standard-Set lässt sich erweitern, einzelne Plugins ersetzen oder die Liste vollständig neu zusammenstellen. Rendering, Navigation, Suche und Routing bleiben damit in der Hand des Projekts statt vom Framework vorgegeben.

Fibel läuft auf Bun und wird in einer einzigen Datei konfiguriert. Inhalte benötigen keinen Build-Schritt, ausgelieferte Seiten enthalten kein Client-Framework.

Schnellstart

bunx --bun @valentinkolb/fibel init
bunx --bun @valentinkolb/fibel dev

init erzeugt fibel.config.ts, eine erste Seite unter docs/en/ und ein assets/-Verzeichnis. dev liefert das Projekt aus und lädt den Browser bei Dateiänderungen neu. Der Entwicklungsserver gibt seine URL beim Start aus.

In Projekten, an denen Coding-Agents arbeiten, kommt zusätzlich der Fibel-Agent-Skill dazu:

bunx skills add ValentinKolb/fibel

Er stellt die aktuellen Konventionen für Konfiguration, Markdown-Seiten, rohe .md-Routen, Plugins, Hosting und Verifikation bereit, damit Agents auf der dokumentierten API arbeiten statt zu raten.

Funktionsumfang

• Seiten aus docs/<locale>/**/*.md, mit Navigation, Sections und Pagination aus dem Frontmatter.
• Serverseitige Suche mit Spotlight-Dialog, zu öffnen mit / oder Mod+K.
• Native Sprachrouten und ein Sprachumschalter, der die aktuelle Seite beibehält.
• Light und Dark Mode serverseitig aufgelöst, der erste Frame stimmt damit bereits.
• Canonical-URLs, hreflang-Alternativen, Sitemap und strukturierte Daten für Suchmaschinen.
• llms.txt und rohe .md-Routen für Werkzeuge, die Dokumentation direkt lesen.
• Eine Plugin-API zum Ersetzen oder Erweitern sämtlicher eingebauter Funktionen.

Maschinenlesbare Ausgabe

Dokumentation wird zunehmend von Werkzeugen verarbeitet statt im Browser gelesen. Fibel stellt jede Seite in einer Form bereit, die diese Werkzeuge verarbeiten können, ohne separaten Export-Schritt:

/de/configuration        die gerenderte Seite
/de/configuration.md     die Markdown-Quelle
/llms.txt                ein Index aller Seiten, nach Section gruppiert
/llms-full.txt           die vollständige Dokumentation in einer Datei

Es handelt sich um stabile URLs, nicht um Datei-Downloads. Seiten, die aus der Navigation ausgenommen sind, fehlen auch hier.

Projektstruktur

Ein Fibel-Projekt besteht aus einer Config-Datei und einem Content-Verzeichnis. Assets sind optional.

fibel.config.ts
docs/
  en/
    index.md
    configuration.md
  de/
    index.md
    configuration.md
assets/

Jedes Locale hat ein eigenes Verzeichnis. docs/de/configuration.md wird als /de/configuration und als /de/configuration.md ausgeliefert. Seiten mit identischem Slug in mehreren Sprachen gelten als Übersetzungen voneinander; daraus ergeben sich sowohl der Sprachumschalter als auch die hreflang-Ausgabe.

Seitenmodell

Eine Seite besteht aus Frontmatter und Markdown-Inhalt.

---
title: Konfiguration
navTitle: Konfiguration
section: Start
order: 2
description: Konfiguriere Routen, Locales, Assets, Theme und Plugins.
tags: [config, routing]
updated: 2026-06-09
---

# Konfiguration

Das Frontmatter steuert Metadaten, Navigation und die Chips unter dem Seitentitel. Alle Felder sind optional: Fehlt title, greift Fibel auf die erste #-Überschrift zurück, fehlt description, auf den ersten Absatz. Das Layout rendert den Titel einmal und lässt die erste #-Überschrift im Text weg, sodass sie nicht doppelt erscheint.

Nächste Schritte

Die Konfiguration behandelt die Einrichtung eines Projekts. Hosting beschreibt den Betrieb als Server oder das Einbinden in eine bestehende Anwendung. SEO dokumentiert, was Suchmaschinen und Sprachmodelle erhalten. Integrierte Plugins listet den Funktionsumfang auf, die Plugin-API beschreibt dessen Erweiterung.