Wiki-Exportformat: Open Knowledge Format

Exportformat 1.0 · Wiki-Format: Open Knowledge Format v0.1 · Stand: 15.09.2026

Aufbau

Jedes Wiki wird als eigenes ZIP-Archiv wikis/<wiki>.zip exportiert, identisch mit dem Wiki-Export im Portal. Das Format folgt dem Open Knowledge Format (OKF) in der Version 0.1 (offene Spezifikation von Google Cloud, Juni 2026): Ein Wiki ist ein Verzeichnis von Markdown-Dateien, jede Datei ist eine Seite, und der Dateipfad ist die Identität der Seite (z. B. prozesse/urlaub.md). Jede Datei beginnt mit einem YAML-Frontmatter zwischen zwei ----Zeilen, danach folgt der Seiteninhalt als Markdown.

Frontmatter-Feld	Pflicht	Inhalt
`type`	ja	Seitentyp, frei wählbar (z. B. Richtlinie, Prozess, Seite)
`title`	nein	Titel der Seite
`description`	nein	Kurzbeschreibung
`resource`	nein	Verweis auf eine externe Quelle (URL)
`tags`	nein	Liste von Schlagwörtern
`timestamp`	nein	Letzte Änderung, ISO 8601
weitere Felder	nein	Werden unverändert übernommen (Datumswerte als ISO-Text)

Bilder und Dateien, die auf Wiki-Seiten eingebunden sind, liegen unter ihrem Pfad im selben Archiv (PNG, JPEG, GIF, WebP, SVG, PDF) und werden aus dem Markdown relativ referenziert. Beispiel einer Seite:

---
type: Richtlinie
title: Urlaubsregelung
description: Beantragung und Genehmigung von Urlaub
tags:
  - HR
  - Onboarding
timestamp: '2026-09-12T14:03:11+00:00'
gueltig_ab: '2026-01-01'
---

# Urlaubsregelung

Urlaub wird über das Portal beantragt und von der Teamleitung genehmigt …

![Ablauf](bilder/urlaub-ablauf.png)

Das Format ist verlustfrei in beide Richtungen: Ein so exportiertes Archiv lässt sich unverändert wieder in hejstack oder in jedes andere Werkzeug einspielen, das Markdown-Verzeichnisse liest. Markdown-Dateien ohne Frontmatter werden beim Import ebenfalls akzeptiert (Titel aus der ersten Überschrift, type = Seite).

Nicht enthalten

Vektor-Embeddings und Textabschnitte des Suchindex. Sie werden beim neuen Anbieter aus den Seiten neu erzeugt.
Zugriffsrechte: welche Teams ein Wiki sehen, steht in freigaben.json, nicht im Archiv.