Dieses Tool wandelt Markdown in Confluence-Wiki-Markup für den Dialog „Markup einfügen“ um oder in das Speicherformat (XHTML), das die REST-API erwartet. README oder Runbook einfügen bzw. eine .md-Datei öffnen und das Ergebnis kopieren.
Zuletzt aktualisiert:
So funktioniert’s
Markdown einfügen
Eine README, ein Runbook oder eine Anleitung einfügen, eine .md-Datei öffnen, von einer URL laden oder das Beispiel nutzen.
Ziel festlegen
Unter „Ausgabeformat“ Wiki-Markup für den Editor oder das Speicherformat für die API wählen; außerdem, wie Hinweise und Code-Sprachen geschrieben werden.
In Confluence einfügen
Im Editor über „+“ → Markup den Typ Confluence-Wiki wählen, Text einfügen und bestätigen. Für die API das Speicherformat als Seiteninhalt senden.
Funktionen
Zwei Zielformate
Wiki-Markup mit h2., {code} und ||Tabellen|| oder Speicherformat mit ac:structured-macro für Code, Info-Panels und Aufgabenlisten.
Hinweise als Makros
GitHub-Alerts wie > [!NOTE] oder > [!WARNING] werden zu den Makros {info}, {tip}, {note} und {warning} statt zu schlichten Zitaten.
Code mit Sprache und Titel
Fenced Code behält die Sprache, umbenannt in Namen, die Confluence hervorhebt, sowie einen title="…" aus der Info-Zeile.
Klare Warnungen
Was Confluence nicht darstellen kann, etwa Fußnoten oder Spaltenausrichtung im Wiki-Markup, steht in einer Liste unter dem Ergebnis.
Grenzen & Datenschutz
Dateien bis 10 MB sind möglich; Eingaben über 256 KB verarbeitet ein Web Worker, damit die Seite flüssig bleibt. Nichts wird hochgeladen, und „Von URL öffnen“ lädt die Datei direkt von der angegebenen Adresse in den Browser.
Was sich auf dem Weg nach Confluence ändert
Im Wiki-Markup erzwingt ein einzelner Zeilenumbruch innerhalb eines Absatzes einen Umbruch. Weich umbrochene Markdown-Zeilen werden deshalb mit Leerzeichen verbunden. Listeneinträge dürfen weder Codeblöcke noch einen zweiten Absatz enthalten; solche Blöcke folgen direkt auf den Eintrag, begleitet von einer Warnung. Fußnoten werden zu hochgestellten Zahlen mit Anmerkungen am Seitenende, weil Confluence kein Fußnoten-Makro hat.
Bilder behalten ihre URL – Anhänge müssen separat zur Seite hochgeladen werden. Formeln bleiben TeX in Monospace, sofern keine LaTeX-App installiert ist. Für den Rückweg gibt es Confluence in Markdown; mehr zum Datenschutz auf der Datenschutzseite.
Häufige Fragen
Wie füge ich Markdown in Confluence ein?
Hier umwandeln, im Confluence-Editor „Einfügen“ → Markup öffnen, Confluence-Wiki auswählen, den Text einfügen und auf Einfügen klicken.
Kann Confluence Cloud Markdown?
Der Cloud-Editor setzt einzelne Markdown-Zeichen beim Tippen um. Bei eingefügten Dokumenten gehen Tabellen, Code-Sprachen und Panels aber verloren – der Weg über das Markup-Dialogfeld erhält sie.
Was ist das Speicherformat?
Das XHTML-basierte Format, in dem Confluence Seiten intern ablegt. Es dient der REST-API und Werkzeugen, die Seiten aus einem Git-Repository veröffentlichen.
Werden Aufgabenlisten übernommen?
Im Speicherformat entstehen echte Confluence-Aufgaben. Wiki-Markup kennt keine Aufgaben, daher erscheinen dort die Zeichen ☐ und ☑.
Lässt sich ein Inhaltsverzeichnis einfügen?
Ja. Mit der Option „Inhaltsverzeichnis“ steht das Makro {toc} am Anfang der Seite.
Wird das Dokument an einen Server geschickt?
Nein, die gesamte Umwandlung erfolgt lokal im Browser.