Word zu Confluence Markdown: Dokumente in Ihren Team Wiki importieren

Confluence ist eines der am häufigsten verwendeten Team-Wikis, und viele Organisationen haben Bibliotheken mit Word-Dokumenten, die zu Confluence gehören. Diese Dokumente sauber zu konvertieren ist schwieriger, als es aussieht Confluences Markdown-Unterstützung hat Eigenheiten. Dieser Leitfaden zeigt Ihnen die zuverlässigsten Word bis Confluence Arbeitsabläufe.

Unterstützt Confluence Markdown?

Confluence hat teilweise Markdown-Unterstützung, ist aber von der Implementierung abhängig:

• Confluence Wolke unterstützt das Markdown-Makro und kann Markdown in bestimmten Kontexten darstellen, aber der native Editor ist sein eigenes Format
• Confluence Datenzentrum / Server hat auch ein Markdown-Makro
• Atlassian Rovo / Neuer Redakteur Neuere Versionen haben die Markdown-Paste-Unterstützung verbessert

Die zuverlässigste Methode für alle Versionen ist die Konvertierung von Word in Markdown mit WordToMD, dann das Markdown-Inhalt mit Confluences Markdown-Import-Funktion einfügen.

Methode 1: Markdown über Confluence Editor einfügen

Schritte

1. Konvertieren Sie Ihr Word-Dokument unter WordToMD und klicken Sie auf Copy Markdown
2. In Confluence öffnen Sie den Seiteneditor
3. Wählen Sie aus dem Menü Einfügen (+ Icon) Markup oder Andere Makros → Markup
4. Wählen Sie Markdown als Sprache
5. Passen Sie den Markdown-Inhalt ein
6. Klicken Sie auf Einfügen

Das Makro Markup/Markdown stellt den Inhalt als Rich Text innerhalb der Seite dar. Es konvertiert nicht in native Confluence-Blöcke, aber es rendert Überschriften, Tabellen und Listen korrekt.

Methode 2: Word Dateien importieren

Confluence Cloud verfügt über eine Word-Import-Funktion:

1. Erstellen einer neuen Confluence-Seite
2. Klicken Sie auf das Menü ... → Word Dokument importieren
3. Wählen Sie Ihre .docx-Datei aus

Dies funktioniert für einfache Dokumente, verliert jedoch die komplexe Formatierung. Die Markdown-Route gibt mehr Kontrolle.

Methode 3: Umwandeln in HTML

Einige Teams bevorzugen HTML als Zwischenformat, da der Confluences-Editor HTML-Paste akzeptiert:

1. Konvertieren Sie Ihre Word doc zu Markdown mit WordToMD
2. Konvertieren Sie das Markdown in HTML mit einem Online-Tool oder marked library
3. Wechseln Sie zum Confluence Source Editor (Ctrl+Shift+D oder aus der Werkzeugleiste)
4. Kleben Sie die HTML

Dieser Ansatz bewahrt eine komplexere Formatierung, ist aber mehr Schritte.

Kompatibilität der Formatierung

Handhabungstabellen

Word-Tabellen werden in GFM-Syntax über die Pipeline umgewandelt WordToMD. Confluence’s Markdown macro renders these correctly:

| Project | Owner | Status |
|---|---|---|
| Website redesign | Alice | In progress |
| API migration | Bob | Complete |

Für kompliziertere Tabellenvorgänge siehe Markdown Tabellen: Eine vollständige Anleitung.

Codeblöcke in Confluence

Confluence hat sein eigenes Code-Block-Makro, das Syntax-Highlighting und Zeilenummern anbietet. Nach dem Importieren von Markdown-Inhalten Sie können Codeblöcke aus dem Markdown-Makro durch native Confluence Code Block-Makros ersetzen, um die Lesbarkeit zu verbessern:

1. Bearbeiten der Seite
2. Finden Sie den Code-Bereich
3. Einfügen eines Code-Block-Makros
4. Setzen Sie die Sprache für die Syntax-Highlighting
5. Einfügen Sie den Code

Referenzen: Markdown Leitfaden für Codeblöcke für die Standardsyntax.

Atlassian Confluence und ADF

Confluence Cloud nativ verwendet Atlassian-Dokumentformat (ADF) ein JSON-Schema für reichhaltige Inhalte. Das Markdown Makro befindet sich hier oben. Bei programmatischen Importen akzeptiert das Confluence REST API direkt ADF. Wenn Sie eine automatisierte Pipeline erstellen, konvertieren Sie Word → Markdown → ADF mit den verfügbaren Bibliotheken.

Für die meisten Teams ist der manuelle Arbeitsablauf einfacher und schneller.

Migration einer Dokumentbibliothek

Wenn Sie Dutzende von Word Dokumenten auf Confluence migrieren:

1. Konvertieren Sie alle Dateien mit WordToMD (oder eine Charge mit Pandoc für große Mengen)
2. Erstellen Sie einen Confluence-Bereich und planen Sie die Seitenhierarchie
3. Seiten in Abschnitte importieren, verwandte Dokumente unter Mutterseiten gruppieren
4. Hinzufügen von Confluence-spezifischen Merkmalen nach dem Import: Etiketten, Seitenbeschränkungen, @Erwähnungen

FAQ

Kann ich Markdown nativ in Confluence ohne das Makro verwenden? In einigen Konfigurationen von Confluence Cloud mit dem neuen Editor können Sie Markdown-Verknüpfungen eingeben und sie konvertieren sich automatisch (e.g. ## erzeugt einen H2). Aber für das Einfügen von konvertierten Dokumenten ist das Markdown-Makro zuverlässiger.

Meine Überschrift-Formatierung ist nach dem Import verloren alles sieht wie Körpertext aus. Dies bedeutet in der Regel, dass das Markdown-Makro nicht aktiv ist. Das Markdown muss sich in einem Markup/Markdown Makro-Block befinden und nicht als einfacher Text in den Standard-Editor eingefügt werden.

Die Tabellen werden als Rohpipezeichen angezeigt. Das gleiche Problem der Inhalt muss sich in einem Markdown-Makro befinden, nicht im Standard-Text-Editor.

Gibt es eine automatisierte Möglichkeit, Word-Dokumente mit Confluence-Seiten zu synchronisieren? Ja Tools wie Confluences Externe Dokumente Funktion, Scroll Versionen, oder benutzerdefinierte Skripte, die Confluence REST API verwenden, können Markdown Dateien automatisch mit Seiten synchronisieren.

Schlußfolgerung

Die saubersten Word bis Confluence Arbeitsablauf ist: Konvertieren mit WordToMD, dann über das Makro Markdown importieren. Für komplexe Dokumente oder Massenmigrationen gibt der HTML Zwischenansatz oder die REST API-Automatisierung mehr Kontrolle. So oder so, die richtige Verwendung von Words Überschriftstylen vor der Konvertierung stellt sicher, dass die Seitenhierarchie intakt durchkommt.