📘 This README is also available in 日本語.
This plugin allows you to convert PlantUML diagrams into Astah, and vice versa:
- Import PlantUML diagrams into Astah Professional
- Export Astah diagrams as PlantUML text
- Astah Professional, Astah UML v10.0 or later
- PlantUML runtime environment
- On Windows, no separate installation of PlantUML or Graphviz is needed because Graphviz is bundled with PlantUML.
- On non-Windows OS, to generate class diagrams or statemachine diagrams, Graphviz must be installed manually.
If the plugin doesn't work, try installing PlantUML manually.
- Download the latest
.jarfile from Releases - Launch Astah and drag & drop the
.jarfile into Astah's window - Restart Astah and create a new project. If you see a "PlantUML View" tab in the bottom-right pane, installation is complete.
After installing the plugin, the "PlantUML View" tab will appear with a PlantUML editor on the left and a preview pane on the right.
▲toAstahgenerates diagrams and models in Astah from PlantUML text▼toPlantexports the current Astah diagram to PlantUML format with preview- Syntax checking runs continuously and displays errors at the bottom
- Ctrl + scroll zooms both the editor and the preview
When importing PlantUML diagrams into Astah, a new diagram is always created.
However, if a blank diagram is already open in the Diagram Editor and its type matches the PlantUML diagram being imported, the elements will be added to the existing open diagram instead of creating a new one.
If the PlantUML code includes multiple diagrams (defined between @startuml and @enduml), each will be imported as a separate diagram in Astah.
When exporting diagrams from Astah to PlantUML, the output is fully regenerated every time. The export does not merge with or update any previously generated PlantUML code.
- PlantUML → Astah conversion
- Astah → PlantUML conversion
- PlantUML Editor
- Continuous validation, error display
- Zoom in/out
- PlantUML Preview
- Continuous preview display
- Zoom in/out
- Common
- Notes (only some diagrams are supported)
- Styles (limited to element colors in some diagrams)
- Class Diagram (Object Diagram)
- Class, Interface
- Stereotype
- Attribute, Operation
- Association, Inheritance, Dependency, Association label
- Multiplicity with labels
- Package
- Object, Link
- Sequence Diagram
- Classifiers: participant, actor, boundary, control, entity
(database, collections, and queue are displayed as participants) - Messages: synchronous, asynchronous, return, Create, Destroy
- Message labels
- Load class from classifier
- Combined Fragment (partially supported)
- Classifiers: participant, actor, boundary, control, entity
- Statemachine Diagram
- Initial state, Final state, State
- Trigger, Guard
- Nested states
- Actions: entry, do, exit
- Pseudostates (partially supported)
- Transition
- Activity Diagram
- Initial node, Final node, Action
- Control flow
- Join Node, Fork Node
- Decision Node
- Object Node
- Partition (simple cases only)
- Usecase Diagram
- Usecase, Actor
- Association, Extend, Include
The following are the main unsupported elements (partial list):
- Common
- Styles (except for colors)
- Class Diagram
- Namespace (ToPlant)
- Entity
- Nested Class
- Sequence Diagram
- Message number
- Activation bars
- Found and Lost Messages
- Time Constraint, Duration Constraint
- InteractionUse
- Statemachine Diagram
- Region
- Activity Diagram
- Legacy syntax
- Complex partitions
- Pin
- Usecase Diagram
- System Boundary
- Package
- Composite Structure Diagram
This plugin uses the following open-source libraries and is distributed under the GPLv3 license:
This plugin internally uses temporary files to display and convert diagrams written in PlantUML within Astah.
However, it does not provide any functionality for users to directly save or export diagrams as image or text files.
According to the PlantUML FAQ, the content of diagrams generated using PlantUML (whether textual or visual) is considered the user’s own work and is not subject to the GPL or other license restrictions . Therefore, it may be used freely.
If you wish to use PlantUML under a license other than GPL (e.g., MIT or LGPL), please refer to the PlantUML License Information.