andriykalashnykov/puml2drawio
Convert PlantUML C4 diagrams to draw.io XML (wraps the catalyst library).
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jul 13, 2026
- License
- MIT
Pinned Snippet
uses: andriykalashnykov/puml2drawio@94b9a34a3a5eae68715897e794459b02ff122ece # v1.6.1tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| input | Input .puml file, directory (recursed), glob pattern, or "-" for stdin | yes | — |
| output | Output file (single input) or directory (batch) | no | — |
| output-ext | Output file extension (batch/glob; single-file when output is a directory). Not applied to stdin. | no | .drawio |
| layout-direction | Layout direction: TB | BT | LR | RL | no | — |
| nodesep | Node separation (px) | no | — |
| edgesep | Edge separation (px) | no | — |
| ranksep | Rank separation (px) | no | — |
| marginx | X margin (px) | no | — |
| marginy | Y margin (px) | no | — |
| theme | Color theme: light (catalyst C4_blue, default) | dark (official C4-PlantUML C4_superhero) | no | — |
| fail-fast | Stop on first batch conversion error (true | false) | no | false |
| exclude | Comma/space-separated glob(s) of input files to skip in directory/glob mode (matched against the collected path AND its basename) | no | — |
| skip-unsupported | Loudly skip files catalyst rejects as an unsupported diagram TYPE (C4_Sequence / zero convertible C4 elements) instead of failing the batch (true | false). Genuine conversion errors still fail. | no | false |
| quiet | Suppress per-file progress output (true | false) | no | false |
| summary | Emit a JSON conversion summary (true | false). Batch/glob: to stdout; single/stdin: to stderr | no | false |
Outputs
no outputs