Diagramm-Rendering¶

ConfluenceSynkMD kann Code-Blöcke verschiedener Diagramm-Sprachen in Bild-Anhänge rendern, die in Ihre Confluence-Seiten eingebettet werden.

Unterstützte Diagrammtypen¶

Typ	Flag	Standard	Externes Tool
Mermaid	`--render-mermaid`	✅ Aktiviert	`@mermaid-js/mermaid-cli` (Node.js)
Draw.io	`--render-drawio`	❌ Deaktiviert	`drawio-desktop` (headless via Xvfb)
PlantUML	`--render-plantuml`	❌ Deaktiviert	Java + das `plantuml` Paket
LaTeX	`--render-latex`	❌ Deaktiviert	LaTeX-Distribution + Ghostscript

Verwenden Sie das veröffentlichte Image? Alle vier Renderer sind in ghcr.io/opendocsync/confluencesynkmd:0.1 vorinstalliert — keine Host-Installation nötig. Mit docker run --rm ghcr.io/opendocsync/confluencesynkmd:0.1 doctor --renderers-only prüfen.

Mermaid¶

Mermaid ist standardmäßig aktiviert:

```mermaid
graph TD
    A[Start] --> B{Entscheidung}
    B -->|Ja| C[Aktion]
    B -->|Nein| D[Ende]
```

Voraussetzungen¶

Node.js 22+
mermaid-cli installieren: npm install -g @mermaid-js/mermaid-cli

Mermaid deaktivieren¶

--no-render-mermaid

Draw.io¶

--render-drawio

PlantUML¶

--render-plantuml

LaTeX¶

--render-latex

Ausgabeformat¶

--diagram-output-format png   # Standard
--diagram-output-format svg

Tip

Verwenden Sie --prefer-raster, um Raster-Output (PNG) zu erzwingen.

Docker¶

Das Docker-Image enthält standardmäßig Mermaid. Für andere Diagrammtypen erweitern Sie das Dockerfile.