plantuml - Man Page
manual page for PlantUML version 1.2024.7 (Sat Sep 07 11:18:17 UTC 2024)
Examples (TL;DR)
- Render diagrams to default format (PNG):
plantuml diagram1.puml diagram2.puml
- Render a diagram in given format (e.g.
png
,pdf
,svg
,txt
):plantuml -t format diagram.puml
- Render all diagrams of a directory:
plantuml path/to/diagrams
- Render a diagram to the output directory:
plantuml -o path/to/output diagram.puml
- Render a diagram without storing the diagram's source code (Note: It's stored by default when the
-nometadata
option isn't specified):plantuml -nometadata diagram.png > diagram.puml
- Retrieve source from a
plantuml
diagram's metadata:plantuml -metadata diagram.png > diagram.puml
- Render a diagram with the configuration file:
plantuml -config config.cfg diagram.puml
- Display help:
plantuml -help
Synopsis
java -jar plantuml.jar [options] -gui
Description
(to execute the GUI)
or java -jar plantuml.jar [options] [file/dir] [file/dir] [file/dir]
(to process files or directories)
You can use the following wildcards in files/dirs
- *
means any characters but '/'
- ?
one and only one character but '/'
- **
means any characters (used to recurse through directories)
where options include
- -author[s]
To print information about PlantUML authors
- -checkmetadata
Skip PNG files that don't need to be regenerated
- -checkonly
To check the syntax of files without generating images
- -charset xxx
To use a specific charset (default is UTF-8)
- -computeurl|-encodeurl
To compute the encoded URL of a PlantUML source file
- -cypher
To cypher texts of diagrams so that you can share them
- -DVAR1=value
To set a preprocessing variable as if '!define VAR1 value' were used
- -darkmode
To use dark mode for diagrams
- -debugsvek
To generate intermediate svek files
- -decodeurl
To retrieve the PlantUML source from an encoded URL
- -disablestats
To disable statistics computation (default)
- -duration
To print the duration of complete diagrams processing
- -e[x]clude pattern
To exclude files that match the provided pattern
- -enablestats
To enable statistics computation
- -encodesprite 4|8|16[z] "file"
To encode a sprite at gray level (z for compression) from an image
- -extractstdlib
To extract PlantUML Standard Library into stdlib folder
- -failfast
To stop processing as soon as a syntax error in diagram occurs
- -failfast2
To do a first syntax check before processing files, to fail even faster
- -filedir xxx
To behave as if the PlantUML source is in this dir (only affects '-pipe' and PicoWeb 'POST /render')
- -filename "example.puml"
To override %filename% variable
- -graphvizdot "exe"
To specify dot executable
- -gui
To run the graphical user interface
- -h[elp]
To display this help message
- -htmlstats
To output general statistics in file plantuml-stats.html
- -I/path/to/file
To include file as if '!include file' were used
- -I/path/to/*.puml
To include files with pattern
- -language
To print the list of PlantUML keywords
- -loopstats
To continuously print statistics about usage
- -metadata
To retrieve PlantUML sources from PNG images
- -nbthread N
To use (N) threads for processing
- -nbthread auto
To use 12 threads for processing
- -noerror
To skip images when error in diagrams
- -nometadata
To NOT export metadata in PNG/SVG generated files
- -o[utput] "dir"
To generate images in the specified directory
- -overwrite
To allow to overwrite read only files
- -Ppragma1=value
To set pragma as if '!pragma pragma1 value' were used
- -p[ipe]
To use stdin for PlantUML source and stdout for PNG/SVG/EPS generation
- -picoweb
To start internal HTTP Server. See https://plantuml.com/picoweb
- -pipeimageindex N
To generate the Nth image with pipe option
- -preproc
To output preprocessor text of diagrams
- -printfonts
To print fonts available on your system
- -progress
To display a textual progress bar in console
- -quiet
To NOT print error message into the console
- -realtimestats
To generate statistics on the fly rather than at the end
- -Sparam1=value
To set a skin parameter as if 'skinparam param1 value' were used
- -splash
To display a splash screen with some progress bar
- -stdlib
To print standard library info
- -syntax
To report any syntax error from standard input without generating images
- -testdot
To test the installation of graphviz
- -theme xxx
To use a specific theme
- -timeout N
Processing timeout in (N) seconds. Defaults to 15 minutes (900 seconds).
- -teps
To generate images using EPS format
- -thtml
To generate HTML file for class diagram
- -tlatex:nopreamble
To generate images using LaTeX/Tikz format without preamble
- -tlatex
To generate images using LaTeX/Tikz format
- -tpdf
To generate images using PDF format
- -tpng
To generate images using PNG format (default)
- -tscxml
To generate SCXML file for state diagram
- -tsvg
To generate images using SVG format
- -ttxt
To generate images with ASCII art
- -tutxt
To generate images with ASCII art using Unicode characters
- -tvdx
To generate images using VDX format
- -txmi
To generate XMI file for class diagram
- -v[erbose]
To have log information
- -version
To display information about PlantUML and Java versions
- -xmlstats
To output general statistics in file plantuml-stats.xml
If needed, you can setup the environment variable GRAPHVIZ_DOT.
(GPL source distribution) Java Runtime: OpenJDK Runtime Environment JVM: OpenJDK 64-Bit Server VM Default Encoding: UTF-8 Language: en Country: null
PLANTUML_LIMIT_SIZE: 4096
Error: Dot executable does not exist Error: only sequence diagrams will be generated