Diagram Rendering¶

ConfluenceSynkMD can render code blocks for various diagram languages into image attachments that are embedded in your Confluence pages.

Supported Diagram Types¶

Mermaid¶

Mermaid is enabled by default. Write standard Mermaid code blocks:

```mermaid
graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Action]
    B -->|No| D[End]
```

Prerequisites¶

• Docker Engine installed and running
• Docker executable available on your PATH

Disable Mermaid¶

--no-render-mermaid

Draw.io¶

Enable Draw.io rendering to convert Draw.io XML code blocks into images:

--render-drawio

```drawio
<mxfile>...</mxfile>
```

Prerequisites¶

Install drawio-export or use the Docker image which can be extended to include it.

PlantUML¶

Enable PlantUML rendering:

--render-plantuml

```plantuml
@startuml
Alice -> Bob: Hello
Bob --> Alice: Hi!
@enduml
```

Prerequisites¶

Install the plantuml binary and ensure it's on your PATH.

LaTeX¶

Enable LaTeX rendering for mathematical formulas:

--render-latex

```latex
E = mc^2
```

Output Format¶

Control the output format for all rendered diagrams:

--diagram-output-format png   # Default
--diagram-output-format svg

Docker¶

The Docker image includes Mermaid by default. For other diagram types, extend the Dockerfile:

# Example: Add PlantUML
RUN apt-get update && apt-get install -y plantuml