CTAN Comprehensive TeX Archive Network

Directory macros/luatex/latex/plantuml



Version 0.3.1

A Lua package for PlantUML in

PlantUML is a program which transforms text into UML diagrams. This package allows for embedding PlantUML diagrams using the PlantUML source.

Currently, this project runs with lualatex only. Check issue #1 for the current state of affairs for support pdflatex.


  1. Environment variable PLANTUML_JAR set to the location of plantuml.jar. You get it from https://sourceforge.net/projects/plantuml/files/plantuml.jar/download.
  2. Enviroment variable GRAPHVIZ_DOT set to the location of dot.exe. Example: C:\Program Files (x86)\Graphviz2.38\bin\dot.exe. You can install graphviz using choco install graphviz.
  3. lualatex available with command line parameter -shell-escape included.
  4. In case you want to have the images as PDFs (and not using TikZ or PNG), ensure that inkscape.exe and pdfcrop are in your path. You can get inkscape using choco install inkscape. pdfcrop should be part of your latex distribution.


Minimal Example


  Alice -> Bob: test

Compilation: lualatex -shell-escape example-minimal

Result:Minimal example

Example Class Relations Rendered Using SVG


  inkscape -z --file=#1 --export-pdf=\OutputFile
class Car

Driver - Car : drives >
Car *- Wheel : have 4 >
Car -- Person : < owns

Compilation: lualatex -shell-escape example-class-relations

Result:Class relations rendered using SVG


Your latex distribution should take care.

For manual installation, copy plantuml.* to your local texmf folder in the subdirectoy tex/latex/plantuml. See the discussion at tex.sx for the concrete location of the folder on your system.


The release is built using GitHub Actions (workflow file) using release.sh.

Release prepration:

  1. Adapt date and version number in plantuml.sty.
  2. Adapt CHANGELOG.md.
  3. Set a git tag and push.

Alternative Solutions

TikZ-UML is a very powerful package based on TikZ. More alternative solutions are collected at the CTAN topic UML.


SPDX-License-Identifier: LPPL-1.3c+

Download the contents of this package in one zip archive (68.9k).

plantuml – Support for rendering UML diagrams using the syntax and tool of PlantUML

The package provides support for rendering UML diagrams using the syntax and tools of PlantUML. The PlantUML syntax is very short and thus enables quickly specifying UML diagrams. Using dot, PlantUML layouts the diagrams.

Home pagehttps://koppor.github.io/plantuml/
Bug trackerhttps://github.com/koppor/plantuml/issues
LicensesThe Project Public License 1.3c
Copyright2018–2020 Oliver Kopp
MaintainerOliver Kopp
Contained inTeX Live as plantuml
MiKTeX as plantuml
TopicsUse Lua
Guest Book Sitemap Contact Contact Author