Joplin Plugin - PlantUML2

> WARNING: I moved my notes to Obsidian.md and I will not provide additional support to this plugin.
> Pull request are welcome.

This plugin allows you to create UML diagrams using the syntax defined in https://plantuml.com.

- Joplin Plugin - PlantUML2
- Install the plugin
- Automatic installation
- Manual installation
- Markdown syntax
- Sequence Diagram Example
- MindMap Diagram Example
- Other functionalities
- Context menu
- Menu shortcuts
- Links to other notes
- Options
- Extra hints
- Known issues
- Rendering of math formulas
- Development

Install the plugin

$3

Use the Joplin plugin manager to install it (Joplin > Options > Plugins).
Search for PlantUML2.

!Plugin Install

$3

- Download the last release from this repository.
- Open Joplin > Options > Plugins > Install from File
- Select the jpl file you downloaded.

Markdown syntax

Use the markdown fence syntax to create a new PlantUML diagram.
Inside this block you can use the syntax documented at https://plantuml.com.

Sequence Diagram Example

Syntax example:

``plantuml
@startuml
Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response

Alice -> Bob: Another authentication Request
Alice <-- Bob: Another authentication Response
@enduml
`

Rendering example:

!Rendering example

MindMap Diagram Example

Syntax example:

`plantuml
@startmindmap
* Debian
** Ubuntu
* Linux Mint
* Kubuntu
* Lubuntu
* KDE Neon
** LMDE
** SolydXK
** SteamOS
** Raspbian with a very long name
* Raspmbc => OSMC
* Raspyfi => Volumio
@endmindmap
`

Rendering example:

!Rendering example

Other functionalities

Context menu

Use the context menu (mouser right click) on the rendered diagram to copy the image or the url.

!Context Menu

Menu shortcuts

If you don't remember the syntax to create a PlantUML diagram you can use the templates in the tools menu

!Tools Menu

Links to other notes

You can create links to other notes inside the PlantUML diagram using the link joplin://. This feature is only available when the rendering format Vector Image (svg) is selected.

Example:

`plantuml
@startmindmap
* Recipes
** [[joplin://983de92ea39448a19e7c9a9b7c797bb0 Pasta]]
* [[joplin://fdb2b25f0ec14864ba65c26a42404bb9 Lasagna]]
** [[joplin://e3880d97001546c79f1dc3584cc6b30d Pizza]]
** [[https://www.giallozafferano.com Other]]
@endmindmap
`

!Links example

Options

Use the plugin's options to define the rendering server and the output format.

!Options

Extra hints

- The tag name is case insensitive
- This plugin is not compatible with WYSIWYG editor
- In order to make the diagram visible while exporting the note, an image cache is created on disk. The cache is located at ${temp}/joplin-plantUml2-plugin/

Known issues

List of plantUml rendering issues that cannot be solved because not related to this plugin but to the official server.

Rendering of math formulas

Code: #3

Problem: Latex math formulas cannot be rendered as svg images

Example:
`
@startuml
skinparam handwritten true
:$int\_0^1f(x)dx$;
:$x^2+y\_1+z\_12^34$;
note right
Try also
$d/dxf(x)=lim\_(h->0)(f(x+h)-f(x))/h$
P(y|\mathbf{x}) \mbox{ or } f(\mathbf{x})+\epsilon
end note
@enduml
`

Workaround: Modify in the plugin options the rendering mode to Raster image (png)`

Development

If you want to contribute to this plugin you can find here some useful references:

- Joplin - Getting started with plugin development
- Joplin - Plugin API reference
- Joplin - Data API reference
- Joplin - Plugin examples