Confluence will nicht, dass du gehst. Atlassian speichert deine Inhalte in einem proprietären XML-Format, bietet keinen Markdown-Export an und macht die Massenextraktion mühsam. Wenn du jemals versucht hast, sauberen Text aus Confluence zu extrahieren, kennst du die Frustration.

Dieser Leitfaden deckt alle Methoden ab, um Confluence-Seiten nach Markdown zu exportieren --- von einzelnen Seiten bis hin zu ganzen Spaces.

Warum Confluence nach Markdown exportieren?

Teams verlassen Confluence aus vielen Gründen:

Migration zu einem neuen Tool --- Wechsel zu Notion, GitBook, Docusaurus oder einem Static-Site-Generator, der Markdown erwartet
Archivierung einer Wissensdatenbank --- Team-Dokumentation sichern, bevor eine Atlassian-Lizenz abläuft
Aufbau einer KI-Wissensdatenbank --- saubere Dokumentation an Claude, ChatGPT oder ein internes LLM liefern
Backup kritischer Dokumente --- eine portable Kopie haben, die nicht von Atlassians Servern abhängt
Vendor-Lock-in vermeiden --- eigene Inhalte in einem universellen Format besitzen

Methode 1: Save (am schnellsten für einzelne Seiten)

Save ist eine Chrome-Erweiterung, die jede Confluence-Seite mit einem Klick in sauberes Markdown konvertiert.

So funktioniert es:

Öffne eine beliebige Confluence-Seite in Chrome
Klicke auf das Save-Erweiterungssymbol
Eine .md-Datei wird sofort heruntergeladen

Was du erhältst:

Vollständiger Seitentext mit Überschriftenhierarchie
Als Markdown-Tabellen formatierte Tabellen
Codeblöcke mit Sprach-Tags
Informationspanele als Blockzitate konvertiert
Auf-/Zuklappbare Abschnitte (vollständig aufgeklappt)
Saubere Metadaten: Seitentitel, Space-Name, Datum der letzten Aktualisierung
Interne und externe Links erhalten

Was entfernt wird:

Atlassian-Makros und proprietäre Formatierungen
Navigations-Chrome, Seitenleisten und Menüs
WYSIWYG-Editor-Artefakte
Inline-Styles und CSS

Am besten für: Einzelne Seiten oder kleine Batches speichern. Für 5 bis 50 Seiten ist das die schnellste Methode.

Beispielausgabe

Aus einem typischen Confluence-Runbook:

# Deployment Runbook --- Production API

**Space:** Engineering
**Last updated:** March 12, 2026

---

## Pre-Deployment Checklist

- [ ] All CI checks passing on `main`
- [ ] Database migrations reviewed and approved
- [ ] Feature flags configured for gradual rollout
- [ ] Rollback plan documented

## Deployment Steps

### 1. Create Release Branch

\`\`\`bash
git checkout -b release/v2.4.0 main
git push origin release/v2.4.0
\`\`\`

### 2. Run Database Migrations

\`\`\`sql
ALTER TABLE users ADD COLUMN preferences JSONB DEFAULT '{}';
CREATE INDEX idx_users_preferences ON users USING GIN (preferences);
\`\`\`

Methode 2: Confluences integrierter Export (HTML, dann konvertieren)

Confluence kann Seiten als HTML exportieren. Du kannst dann das HTML mit einem Tool wie Pandoc in Markdown umwandeln.

Schritte:

Zur Seite gehen → …-Menü → In PDF/Word/HTML exportieren
HTML-Export wählen
Mit Pandoc konvertieren: pandoc input.html -o output.md

Probleme mit diesem Ansatz:

HTML-Export enthält Atlassians CSS, Makros und Inline-Styles
Tabellen brechen während der Konvertierung oft kaputt
Codeblöcke verlieren Sprach-Tags
Bilder verweisen auf Confluence-URLs, die später möglicherweise nicht mehr funktionieren
Verschachtelte Seiten erfordern den Export des gesamten Spaces

Diese Methode funktioniert, produziert aber unordentliche Ausgaben, die manuell bereinigt werden müssen.

Methode 3: Space-Export + Massenkonvertierung

Für den Export eines gesamten Confluence-Spaces:

Zu Space-Einstellungen → Content-Tools → Exportieren gehen
Format HTML wählen
ZIP-Archiv herunterladen
Ein Skript verwenden, um HTML-Dateien stapelweise nach Markdown zu konvertieren

Das Problem: Confluence-Space-Exporte erzeugen tief verschachteltes HTML mit defekten relativen Links, duplizierten Navigationselementen und Atlassian-spezifischem Markup. Das programmatisch zu bereinigen ist ein Wochenendprojekt.

Methode 4: Confluence REST API

Für programmatischen Zugriff:

curl -u [email protected]:API_TOKEN \
  "https://your-domain.atlassian.net/wiki/rest/api/content/PAGE_ID?expand=body.storage" \
  | jq -r '.body.storage.value' > page.html

Das liefert das rohe Storage-Format (XHTML-ähnlich). Du musst dann:

Das Atlassian-Storage-Format parsen
Makros, Einbettungen und spezielle Elemente verarbeiten
In Markdown umwandeln
Für jede Seite wiederholen

Am besten für: Engineering-Teams, die eine Migrationspipeline aufbauen. Für die meisten Anwendungsfälle überdimensioniert.

Welche Methode sollte ich verwenden?

Szenario	Beste Methode
1–50 Seiten schnell speichern	Save-Erweiterung --- ein Klick pro Seite
Einen ganzen Space archivieren	Space-Export + Pandoc --- in Masse, aber unordentlich
Eine Migrationspipeline aufbauen	REST API --- programmatisch, aber komplex
Schnelles Backup wichtiger Docs	Save-Erweiterung --- sauberste Ausgabe
Docs an ein LLM liefern	Save-Erweiterung --- Markdown ist LLM-nativ

Für die meisten Menschen ist Save die Antwort. Es produziert das sauberste Markdown ohne jede Einrichtung und verarbeitet Confluences proprietäre Formatierung automatisch.

Confluence-Inhalte nutzbar machen

Sobald du deine Seiten nach Markdown exportiert hast, kannst du:

Alles durchsuchen mit grep, VS Code oder Obsidian
Es an Claude oder ChatGPT übergeben für sofortige Antworten zu deiner Dokumentation
Es in Git versionieren --- Änderungen an deinen Docs wie Code verfolgen
In jedes Tool importieren --- Notion, Obsidian, GitBook, Docusaurus oder einen Static-Site-Generator
Es für immer behalten --- Markdown-Dateien sind Klartext. In 50 Jahren noch lesbar

Loslegen

Save installieren und jetzt an einer Confluence-Seite ausprobieren. Es ist kostenlos zu starten, und du siehst sauberes Markdown in Sekunden.

Confluence zu verlassen muss nicht schmerzhaft sein. Save konvertiert jede Seite mit einem Klick in sauberes Markdown.