Mr. Tools

How to

How to use PlantUML Preview

A tool for drafting PlantUML syntax and checking the preview in the same workspace. It is useful when you want to review the structure of sequence diagrams or class diagrams. Theme switching and multiple-page management are also available for comparing diagram variations.

PlantUML Preview thumbnailPlantUML Preview thumbnail

Use Cases

When to use it

  • Draft UML diagrams in syntax form
  • Review the structure before adding diagrams to documentation
  • Compare multiple diagram variants using tabs
  • Quickly check a class or state diagram in syntax form
  • Clean up a UML diagram structure before sharing with the team
  • Verify how a diagram looks before adding it to a specification

Capabilities

What this tool can do

  • Check PlantUML syntax and preview side by side
  • Switch themes
  • Manage multiple source pages
  • Save or copy the diagram as SVG or PNG
  • Manage separate diagrams across multiple pages
  • Support sequence, class, state, and other major UML types

Guide

How to use each screen area

Learn how to use each screen area, including settings, input, previews, results, and saving.

01 HOWTO

Syntax editor area

Write PlantUML syntax in the left editor. Start from a diagram template, add context-aware insert suggestions, and check the structure in the preview as you edit.

Screen showing Syntax editor area in PlantUML PreviewScreen showing Syntax editor area in PlantUML Preview

What this area does

  • Enter PlantUML syntax directly
  • Insert a starter template for the diagram type
  • Add suggestions that match the current diagram type
  • Fix input while checking preview errors

Where to use it

01
Syntax input

Enter PlantUML syntax for sequence diagrams, class diagrams, state diagrams, and other diagrams.

Screen showing where to use Syntax input in PlantUML PreviewScreen showing where to use Syntax input in PlantUML Preview
02
Template selection

When the editor is empty, choose a diagram type and insert the basic @startuml to @enduml structure.

Screen showing where to use Template selection in PlantUML PreviewScreen showing where to use Template selection in PlantUML Preview
03
Input suggestions

Add matching items such as participants, messages, classes, or relationships at the cursor position.

Screen showing where to use Input suggestions in PlantUML PreviewScreen showing where to use Input suggestions in PlantUML Preview
04
Error review

When the syntax has a problem, use the preview-side message to correct the input.

Screen showing where to use Error review in PlantUML PreviewScreen showing where to use Error review in PlantUML Preview

02 HOWTO

Input suggestions and editor tools

Use the templates and suggestions above the editor, the history control in the top bar, and clear or copy actions in the editor header. This area helps you create a base diagram, add parts, and reuse a draft.

Screen showing Input suggestions and editor tools in PlantUML PreviewScreen showing Input suggestions and editor tools in PlantUML Preview

What this area does

  • Insert a template for the diagram type
  • Add parts that match the current diagram
  • Return to a recent editing state from history
  • Clear or copy the current syntax

Where to use it

01
Templates

Choose a starter structure for a sequence diagram, class diagram, state diagram, or another diagram type.

Screen showing where to use Templates in PlantUML PreviewScreen showing where to use Templates in PlantUML Preview
02
Suggestions

Add parts such as participants, messages, classes, or relationships that fit the current syntax.

Screen showing where to use Suggestions in PlantUML PreviewScreen showing where to use Suggestions in PlantUML Preview
03
History and draft

The browser keeps your current draft, and the history menu lets you return to a recent editing state.

Screen showing where to use History and draft in PlantUML PreviewScreen showing where to use History and draft in PlantUML Preview
04
Clear input

Remove the current syntax and start a new diagram.

Screen showing where to use Clear input in PlantUML PreviewScreen showing where to use Clear input in PlantUML Preview
05
Copy syntax

Copy the draft syntax into a README, specification, or external note.

Screen showing where to use Copy syntax in PlantUML PreviewScreen showing where to use Copy syntax in PlantUML Preview

03 HOWTO

Preview and theme area

Use the right preview pane to confirm the rendered PlantUML diagram and switch the theme before sharing. If rendering fails, the error appears in this same area.

Screen showing Preview and theme area in PlantUML PreviewScreen showing Preview and theme area in PlantUML Preview

What this area does

  • Switch the preview theme
  • Confirm the rendered diagram
  • Review rendering errors
  • Return to the input and revise the syntax

Where to use it

01
Switch theme

Change the background and line colors to match where the diagram will be shared.

Screen showing where to use Switch theme in PlantUML PreviewScreen showing where to use Switch theme in PlantUML Preview
02
Review diagram

Check whether the PlantUML syntax renders into the intended diagram.

Screen showing where to use Review diagram in PlantUML PreviewScreen showing where to use Review diagram in PlantUML Preview
03
Review errors

When the diagram cannot render, read the error message before editing the syntax.

Screen showing where to use Review errors in PlantUML PreviewScreen showing where to use Review errors in PlantUML Preview
04
Edit input

Use the preview result as feedback while revising the syntax in the editor.

Screen showing where to use Edit input in PlantUML PreviewScreen showing where to use Edit input in PlantUML Preview

04 HOWTO

Output format, copy, and download area

Use the output controls above the preview to choose SVG or PNG, then copy or download the rendered diagram. If export is not available, review the error and return to the input.

Screen showing Output format, copy, and download area in PlantUML PreviewScreen showing Output format, copy, and download area in PlantUML Preview

What this area does

  • Choose SVG or PNG as the output format
  • Copy the rendered diagram as an image
  • Download the rendered diagram as a file
  • Copy the original PlantUML syntax
  • Review errors when export is not possible

Where to use it

01
Output format

Switch between SVG and PNG depending on where you will share or paste the diagram.

Screen showing where to use Output format in PlantUML PreviewScreen showing where to use Output format in PlantUML Preview
02
Copy image

Copy the rendered diagram in the selected format and paste it into a document or chat.

Screen showing where to use Copy image in PlantUML PreviewScreen showing where to use Copy image in PlantUML Preview
03
Download image

Save the rendered diagram as an SVG or PNG file.

Screen showing where to use Download image in PlantUML PreviewScreen showing where to use Download image in PlantUML Preview
04
Copy syntax

Copy the PlantUML syntax used to create the diagram and share it with the image.

Screen showing where to use Copy syntax in PlantUML PreviewScreen showing where to use Copy syntax in PlantUML Preview
05
Review errors

When the diagram cannot be exported, check the error and return to the input.

Screen showing where to use Review errors in PlantUML PreviewScreen showing where to use Review errors in PlantUML Preview

Notes

Notes

Important points are grouped with reasons so you can make decisions before using the tool.

Things to check

Start from the smallest syntax that renders

If you add many elements at once, it becomes harder to separate syntax issues from relationship issues. Start small and expand gradually.

Things to check

Choose SVG or PNG based on where you will share it

Use SVG when you want to keep editing quality, and PNG when you want to paste it into chat or slides quickly.

Note

Preview requires a connection to an external server

PlantUML preview needs network access to render diagrams. The preview will not appear without an internet connection.

FAQ

Questions about PlantUML Preview

Questions that make decisions easier before use are summarized first.

How is it different from Mermaid?

It is intended for PlantUML syntax and UML-focused diagram authoring. You can switch between different notation tools by document.

Can I save the result as an image right away?

SVG and PNG actions depend on the preview engine connection. When it is not connected yet, the preview panel shows an error.

What diagram types can I draw?

Sequence diagrams, class diagrams, state diagrams, use-case diagrams, Gantt charts, and other major PlantUML types are supported.

Where can I look up the syntax?

The official PlantUML documentation lists the syntax for each diagram type. You can type syntax and check the result in this page at the same time.

How do I share a diagram as an image?

Download it as SVG or PNG, or copy it to the clipboard and share from there.

Does it work offline?

PlantUML preview requires a connection to an external server. The preview will not appear without network access.

Next guides

Related guides

Related guides are listed next so you can continue without getting lost.