Pandoc filter which converts PlantUML code blocks to PlantUML images.
```plantuml
Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response
Alice -> Bob: Another authentication Request
Alice <-- Bob: another authentication Response
## Usage
Install it with pip:
pip install pandoc-plantuml-filter
And use it like any other pandoc filter:
pandoc tests/sample.md -o sample.pdf --filter pandoc-plantuml
The PlantUML binary must be in your `$PATH` or can be set with the
`PLANTUML_BIN` environment variable.
### Additional parameters
You could pass additional parameters into `plantuml` filter which will be processed as picture's options:
Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response
The `plantuml-filename` parameter create a symlink for the destination picture, which could be used in the same file as an image directly.
### Control the output file-type
The generated file-type can be controlled via the file metadata:
Or directly via the cli `--metadata` argument.
pandoc tests/sample.md -o sample.pdf --filter pandoc-plantuml --metadata=plantuml-format=svg
## But there is ...
There are a few other filters trying to convert PlantUML code blocks however
they all failed for me.