As of version 7997, PlantUML has introduced the feature to generate diagrams directly into
LaTeX, leveraging the capabilities of the
Tikz package.
Beta Version Notice
Please be aware that this functionality is currently in beta. While it adds a promising direction for PlantUML, it might contain bugs or unsupported features. We encourage users to actively report any issues encountered on first forum (Q&A) thread listed below to help us improve this feature based on actual user feedback and needs.
How to Use LaTeX Generation
To use LaTeX generation, apply the following settings in your PlantUML environment:
- Use the
-tlatex
flag when operating through the command line.
- Set
format="latex"
when configuring the Ant task.
Embedding in LaTeX Documents
If you want to incorporate the LaTeX output directly within another LaTeX document, use option
-tlatex:nopreamble
. PlantUML will output only the tikz-picture component, excluding the document preamble, facilitating a seamless integration into your existing LaTeX files.
@startuml
class Subscriber {
subscriberId
}
class AccumUsage {
subscriberId
}
class IpSession {
ipAddress
specificData
sapcOriginStateId
apnId
}
Subscriber "1" -[#blue]-> "1..*" IpSession
Subscriber "1" --> "0..1" AccumUsage
@enduml
@startuml
Bob -> Alice: hello
return Ok
@enduml
(TODO:
#362 provide some examples in Overleaf)
When utilizing the
hyperref
package in your LaTeX documents, you have the ability to craft links that lead to defined anchors within the same LaTeX/PDF document. In the PlantUML example below, notice that the second and last links point to a specific resource within the LaTeX document:
@startuml
participant Bob [[http://www.yahoo.com]]
participant Alice [[latex://resource-interaction]]
Bob -> Alice : [[http://www.google.com]] hello
Bob -> Alice : [[latex://resource-interaction]] interact
@enduml
For a detailed discussion and related queries, see the second Q&A thread below.
- Q&A 1798: Latex TikZ support
- Q&A 3558: export to TikZ loses links
- Q&A 10761: Latex export limitations (font size, hyperlinks, PNG in header, scaling image to page)
- Q&A 10788: How to set Latex Font Size
- Latex PlantUML package (Oliver Kopp 2018-2023): home, Github, CTAN
- Stackoverflow 71409448 PlantUML in Latex
- Extra idea: use Markdown with Pandoc (LaTeX runs under the hood to generate PDF files): PlantUML diagrams work fine
- TeX Exchange 428174: Can I use the plantUML language in LaTeX? Yes, and prerequisites to install are listed