Markdown in Confluence Wiki-Markup umwandeln

Wenn Sie in Markdown schreiben, aber mit einem Team zusammenarbeiten, das Atlassian Confluence verwendet, kennen Sie sicher die Formatierungslücke: Confluence Data Center und Server verwenden eine eigene Wiki-Markup-Syntax, die völlig anders aussieht als Markdown.

Dokumente manuell umzuschreiben ist mühsam und fehleranfällig. md-to.com bietet einen kostenlosen, browserbasierten Konverter, der Markdown in Echtzeit in Confluence Wiki-Markup umwandelt.

Dieser Artikel zeigt, was das Tool unterstützt, wie man es verwendet und worauf man achten muss.

---

Welche Syntax wird unterstützt?

Der Konverter verarbeitet die folgenden Markdown-Elemente und übersetzt sie in ihre Confluence-Entsprechungen:

Textformatierung

Markdown	Confluence-Ausgabe
**fett**	*fett*
*kursiv*	_kursiv_
~~durchgestrichen~~	-durchgestrichen-
`Inline-Code`	{{Inline-Code}}

Überschriften

Markdown # bis ###### werden in Confluence zu h1. bis h6.:

## Abschnittstitel

wird zu:

h2. Abschnittstitel

Links und Bilder

• [Google](https://google.com) wird zu [Google|https://google.com]
• ![Alternativtext](https://example.com/img.png) wird zu !https://example.com/img.png|alt=Alternativtext!

Codeblöcke

Umzäunte Codeblöcke werden in Confluence {code}-Makros umgewandelt. Die Sprachkennung bleibt erhalten:

```javascript
function greet(name) {
  return "Hello, " + name;
}
```

wird zu:

{code:language=javascript}
function greet(name) {
  return "Hello, " + name;
}
{code}

Codeblöcke ohne Sprachkennung lassen das :language=-Attribut weg.

Tabellen

Markdown-Tabellen werden mit || für Kopfzellen und | für Datenzellen konvertiert:

| Name | Alter |
|------|-------|
| Alice | 30 |

wird zu:

||Name||Alter||
|Alice|30|

Pipe-Zeichen innerhalb von Zellen werden automatisch maskiert.

Listen

• Ungeordnete Listen verwenden *, mit ** für verschachtelte Einträge, *** für tiefere Verschachtelung usw.
• Geordnete Listen verwenden #, mit ## für verschachtelte Einträge.
• Aufgabenlisten werden konvertiert: - [x] wird zu (/) (erledigt) und - [ ] wird zu (x) (nicht erledigt).

Blockzitate

Blockzitate werden in {quote}...{quote} eingeschlossen. Verschachtelte Blockzitate werden in einen einzelnen {quote}-Block zusammengefasst, da Confluence keine verschachtelten Zitate unterstützt.

Horizontale Linien

--- in Markdown wird zu ---- in Confluence.

---

Verwendung

1. Fügen Sie Ihr Markdown ein im linken Editor unter md-to.com/markdown-to-confluence.
2. Sehen Sie die Ausgabe auf der rechten Seite — sie wird beim Tippen aktualisiert.
3. Kopieren oder laden Sie herunter das Confluence Wiki-Markup über die Schaltflächen oberhalb des Ausgabebereichs.

Der Editor synchronisiert das Scrollen zwischen Eingabe und Ausgabe, sodass Sie lange Dokumente durchsehen können, ohne die Orientierung zu verlieren.

---

Funktionsweise

Der Konverter basiert auf markdown-it, einem Markdown-Parser, der einen Token-Stream (einen abstrakten Syntaxbaum) erzeugt. Anstatt fragile Regex-Ersetzungen zu verwenden, durchläuft das Tool den Token-Baum und rendert jeden Knoten in das entsprechende Confluence-Markup.

Dieser Ansatz bedeutet:

• Verschachtelte Strukturen (Listen in Listen, Codeblöcke in Listenelementen) werden korrekt verarbeitet.
• Sonderzeichen in Links, Bildern und Tabellenzellen werden bei Bedarf maskiert.
• Die Ausgabe bleibt konsistent mit der Art, wie markdown-it die Eingabe interpretiert, und vermeidet Überraschungen bei Randfällen.

Die gesamte Verarbeitung findet lokal in Ihrem Browser statt. Es werden keine Daten an einen Server gesendet.

---

Kompatibilität und Einschränkungen

Zielumgebung: Die Ausgabe ist für Confluence Data Center / Server oder den Legacy-Markup-Einfügemodus in Confluence Cloud konzipiert. Der neue Editor in Confluence Cloud akzeptiert kein Wiki-Markup direkt.

Bekannte Einschränkungen:

• Verschachtelte Blockzitate werden zusammengefasst — Confluence Wiki-Markup hat keine Unterstützung für verschachtelte {quote}.
• Rohes HTML in Markdown wird ignoriert (der Parser hat HTML deaktiviert).
• Erweiterte markdown-it-Plugins (Fußnoten, Definitionslisten usw.) sind nicht aktiviert.

---

Zusammenfassung

Wenn Sie Markdown-Inhalte in Confluence Data Center oder Server übertragen müssen, übernimmt dieser Konverter die Syntax-Zuordnung für Sie — Überschriften, Formatierung, Codeblöcke, Tabellen, Listen und mehr.

Probieren Sie es unter md-to.com/markdown-to-confluence aus.

---

Ressourcen:

• md-to.com Markdown zu Confluence Konverter