Content Office
Blog

Markdown-Export aus Content-Office: Migration in Headless CMS, Confluence und Wissensbasen

Wer Inhalte aus einem bestehenden Blog oder Redaktionsprozess in ein neues System migriert, scheitert selten am Text – sondern an Strukturen, Metadaten, Links und Bildern. Der Markdown-Export in Content-Office ist ein pragmatischer Dreh- und Angelpunkt: Sie erhalten Ihre Beiträge als portable .md-Dateien und können sie kontrolliert in Headless CMS, Confluence oder Git-gestützte Wissensdatenbanken überführen – ohne Vendor-Lock-in und ohne Copy-&-Paste-Orgie.

Wann der Markdown-Export der schnellste Weg ist

  • Headless-Umstieg: Inhalte aus dem bisherigen Blog in ein Headless CMS (z. B. Contentful, Strapi, Sanity) überführen.
  • Intranet/Confluence: Wissensartikel und Prozessdokumentationen zentralisieren.
  • Git-basierte Knowledge Bases: Entwicklerdokus/How-tos als Markdown in Repos oder Wikis pflegen.
  • Archiv & Datenhoheit: Vollständige Sicherung Ihrer Inhalte als ZIP, jederzeit wieder nutzbar.

So holen Sie saubere Inhalte aus Content-Office

  1. Export starten: Sämtliche Inhalte lassen sich als Sammlung von Markdown-Dateien exportieren (ZIP). Das Ergebnis ist portabel und unabhängig vom Zielsystem.
  2. Export prüfen: Entpacken, Ordnerstruktur sichten, ggf. nach Projekten/Kanälen filtern. Benennen Sie eine Arbeitskopie, um Skripte gefahrlos zu testen.
  3. Konventionen festlegen: Wie entstehen künftig Slugs, Autoren, Tags und Datumswerte? Klären Sie das vor der Migration, nicht mittendrin.

Struktur und Metadaten: Feld-Mapping einmal sauber definieren

Viele Headless- und Wissenssysteme speichern Inhalt und Metadaten getrennt. Für Markdown gibt es zwei gängige Wege:

  • Metadaten im Zielsystem pflegen: Titel, Datum, Tags und Slug als Felder, Body als Markdown. Vorteil: klare Trennung, sauberes API-Modell.
  • Optionales Front Matter nutzen: YAML/JSON-Block am Dateianfang, der vom Importer gelesen wird. Vorteil: alles in einer Datei versionierbar.

Beispiel für Front Matter plus Body (optional, wenn Ihr Zielsystem es unterstützt):

---
title: "Beispielartikel"
slug: "beispielartikel"
date: "2026-09-06T08:30:00Z"
excerpt: "Kurzfassung des Artikels in ein bis zwei Sätzen."
tags: ["B2B", "Praxis", "Leitfaden"]
author: "Redaktion"
---

# Überschrift im Zielsystem optional weglassen

Einleitungstext in Markdown. Zwischenüberschriften, Listen, Bilder, Links – alles portabel.

Wichtig: Viele Content-Office-Artikel starten ohne h1-Überschrift im Body (weil der Titel separat geführt wird). Legen Sie fest, ob Ihr Zielsystem den Titel als Feld nutzt oder ob die erste Markdown-Zeile eine h1 sein soll – doppelte Titel wirken sonst unprofessionell.

Migration in ein Headless CMS – Schritt für Schritt

Unabhängig vom konkreten Anbieter hat sich dieser Ablauf bewährt:

  1. Content-Typ anlegen: Felder für Titel (Text), Slug (eindeutig), Datum (Datum/Uhrzeit), Excerpt/Kurzfassung (Text), Tags (Liste) und Body (Langtext/Markdown). Optional: Autor, Lesezeit, Canonical-URL.
  2. Slug-Regel definieren: Kleinbuchstaben, Bindestrich, keine Sonderzeichen. Legen Sie fest, ob der Dateiname, ein vorhandener Export-Slug oder eine Neuvergabe maßgeblich ist.
  3. Importweg wählen:
    – Manuell: Einzelne Kernbeiträge per Copy-&-Paste übernehmen (schnell für kleine Mengen).
    – Halbautomatisch: Markdown in ein CSV/JSON transformieren und per GUI/CLI importieren.
    – Vollautomatisch: Per API-Skript Ordner iterieren, Front Matter lesen (falls vorhanden) und Datensätze anlegen.
  4. Medien klären: Bilder separat hochladen (CDN/Asset-Library) und im Markdown auf die endgültigen URLs umschreiben. Prüfen Sie Alt-Texte.
  5. Interne Links umschreiben: Alte Blog-URLs auf neue Slugs mappen. Pflegen Sie Weiterleitungen im Quellsystem, damit existierende Links nicht ins Leere laufen.
  6. Review & Publish: Stichproben für Formatierung, Codeblöcke, Tabellen und Sonderzeichen (Umlaute) durchführen; erst dann go-live.

Praxis-Hinweis: Beginnen Sie mit 5 repräsentativen Artikeln als „Migrations-MVP“. Erst wenn die Feldstruktur, Slug-Regel und Linkumschreibung sitzt, migrieren Sie den Rest im Batch.

Migration nach Confluence (Intranet/Wiki)

  • Seitenstruktur: Ordner/Spaces vorab planen (Themen, Teams, Produkte). Lange Blogartikel als thematische Confluence-Seiten neu schneiden statt 1:1 zu kippen.
  • Import: In Confluence Cloud den Markdown-Import/Makro nutzen oder Inhalte einfügen und formatieren. Bilder separat als Anhänge hochladen und im Text referenzieren.
  • Formatierung prüfen: Tabellen, Callouts/Tipps, Einrückungen und Codeblöcke kontrollieren. Wo nötig, Confluence-eigene Makros verwenden.
  • Interne Links: Querverweise auf Confluence-Seiten statt absolute Blog-URLs. Setzen Sie Inhaltsverzeichnisse pro Seite für bessere Orientierung.

Wissensdatenbanken auf Git-/Dateibasis

  • GitHub/GitLab Wiki oder Docs-Ordner: .md-Dateien ins Repo übernehmen, Ordnerstruktur nach Themen bilden, README.md als Einstieg pro Ordner.
  • Obsidian/Filesystem: Projektordner anlegen, Tags als Hashtags im Text oder über YAML-Tags führen; Backlinks prüfen.
  • Notion & Co.: Markdown-Import nutzen; Front Matter wird teils ignoriert – Metadaten danach als Eigenschaften ergänzen.

Stolperfallen – und wie Sie sie vermeiden

  • Doppelte Titel: Entscheiden Sie, ob der Titel als Feld oder als h1 im Body geführt wird – nicht beides.
  • Interne Links: Alte Pfade rechtzeitig erfassen und auf neue Slugs/IDs mappen; Weiterleitungen einrichten.
  • Bilder: Relative Pfade brechen nach der Migration. Ziel-URLs früh festlegen, Alt-Texte mit übertragen.
  • Shortcodes/Embeds: Proprietäre Shortcodes aus alten Systemen in Standard-Markdown oder HTML umwandeln; externe Embeds durch Links ersetzen.
  • Zeitzonen/Datum: Veröffentlichungszeit konsequent in UTC oder eine feste Zone normalisieren.
  • Encoding: UTF‑8 ohne BOM, Sonderzeichen (Umlaute/ß) stichprobenartig prüfen.
  • Listen/Abstände: Markdown-Renderer unterscheiden sich leicht; bei Bedarf einheitliche Style-Guides festlegen.

Zwei Playbooks: klein anfangen oder skalieren

Playbook A – 90 Minuten, manuell (bis 15 Artikel)

  1. Export aus Content-Office entpacken, 10–15 Kernbeiträge auswählen.
  2. Im Zielsystem Content-Typ/Felder anlegen, Slug-Regel festlegen.
  3. Pro Artikel: Titel/Excerpt/Tags anlegen, Body einkopieren, Bilder hochladen und verlinken.
  4. Interne Links prüfen, Seite veröffentlichen, Weiterleitungen im Alt-System setzen.

Playbook B – skriptgestützt (50+ Artikel)

  1. Konventionen fixieren: Feld-Mapping, Slugs, Medienpfade, Datumsformat.
  2. Preprocessing: Optional Front Matter aus Dateiname/Ordner ableiten; Link-Umschreibung batchweise.
  3. Importer: API/CLI des Zielsystems nutzen, Rate-Limits und Fehler-Logs beachten.
  4. Validierung: 5–10 Stichproben gegen Quelle vergleichen, dann Gesamtlauf starten.

Praxisbeispiele

1) B2B-Mittelständler zieht in ein Headless CMS um

Aus 80 Blogartikeln werden strukturierte Einträge mit Feldern für Titel, Slug, Datum, Tags und Markdown-Body. Bilder wandern in die Asset-Library, interne Links werden per Mapping-Tabelle auf neue Slugs umgeschrieben. Ergebnis: schneller Seitenaufbau im Frontend, saubere API-Nutzung – Inhalte bleiben 1:1 erhalten.

2) Agentur konsolidiert How-tos in Confluence

Projektübergreifende Leitfäden aus Content-Office gehen als thematisch gruppierte Seiten in Confluence live. Tabellen werden in Confluence nachgebaut, Codeblöcke mit Sprachsyntax formatiert, Querverlinkungen auf Seitenebene gesetzt. Ergebnis: auffindbare, versionierbare Doku statt verstreuter PDFs.

3) Verein migriert ins GitHub-Wiki

Rückblicke und Anleitungen aus dem Export werden als Markdown-Dateien in das Wiki-Repo übernommen. Eine Startseite verlinkt auf Monatsordner, Bilder liegen auf einem kostenlosen CDN. Ergebnis: transparente Historie, einfache Mitarbeit über Pull Requests.

Fazit

Mit dem Markdown-Export bleiben Ihre Inhalte aus Content-Office portabel – ideal für Headless CMS, Confluence und dateibasierte Wissensbasen. Entscheidend sind ein klares Feld-Mapping, saubere Slugs, konsistente Medienpfade und die Umschreibung interner Links. Starten Sie mit wenigen Artikeln als Muster, automatisieren Sie erst dann. Wer seine Redaktion zusätzlich beschleunigen möchte, testet Content-Office 30 Tage kostenlos: Themen finden, Entwürfe erstellen, Qualität prüfen – und bei Bedarf jederzeit als Markdown exportieren.

Zurück zur Übersicht