Text to UML tools – Fastest way to create your models

A textual UML tool supports the use of textual notations/languages to describe UML models and automatically renders the corresponding graphical UML diagram from that textual description (a few tools also target other kinds modeling languages, like ER or BPMN, and we mention them here as well, but they are the exception).

The textual UML tools market is one of the fastest growing segment in the UML tools market (based on my own perception of visitors’ interest). Together with online modeling tools, they are the go-to option for all people looking for some kind of lightweight solution to draw some models. In fact, since most textual UML tools have an online editor, they are a jackpot for occasional modelers.

But why are text-to-UML tools so popular? The short answer is that textual modeling tools have a very low barrier to entry. The fact that UML models are stored as text simplifies their integration with a variety of tools (like version control systems) that programmers already use in their everyday work so there’s no need to learn/buy/install additional tools. And programmers typically feel more comfortable with textual languages than with graphical ones. Both aspects represent a huge boost for the adoption of these tools.

Still, as you’ll see in the list below, features, expressiveness, and robustness of such tools are rather limited in most cases. That’s why I was saying that these tools are more of an option for quick and dirty model sketches (for documentation or blueprints for early design discussions) more than a serious and deep modeling activity. I wonder if this typical usage scenario is what discourages company to (barely) offer any kind of commercial solution for this market.

Complete list of online tools to render UML models from a few lines of text Click To Tweet

Let’s see our complete list of text to UML tools. I tried to include all tools I’m aware of. If you think yours is missing please leave a comment and I’ll add it. Note that I’m listing here end-user modeling tools. If you’re looking for (JavaScript) libraries that help you to create your own modeling editor, go here.

Most promising UML textual modeling tools

In no particular order, these are the tools you should check first when looking for a quick and easy way to draw some UML diagrams. As long as you are interested in drawing class diagrams, sequence diagrams or use case diagrams you’ll find several options. A couple also support state machines. Coverage of other kinds of UML diagrams is rather poor.

PlantUML

PlantUML is the most well-known UML tool in this category with millions of UML rendered.  We have covered it in-depth in this interview with his creator  but, in short, it supports all important UML diagrams (class, use case, activity, sequence, component, deployment and object diagrams but, to me, the strong point of this tool is the variety of scenarios in which can be used. There’s a huge ecosystem of tools around PlantUML to render textual UML diagrams anywhere you want.

PlantText UML Editor embeds PlantUML in a live online editor.

PlantUML - textual UML tool

Simple PlantUML Sequence diagram

yUML

yUML is an online service for creating class and use case diagrams, with activity diagrams and state machines anounced to come soon. It’s makes it really easy for you to: Embed UML diagrams in blogs, emails and wikis, post UML diagrams in forums and blog comments, use directly within your web based bug tracking tool or copy and paste UML diagrams into MS Word documents and Powerpoint presentations.

The service can be called from your blog or web page (with the textual description as part of the URL) to automatically display the image when accessing it. As paid options, you can use your own namespace for the images or even install it on your own host. Several integrations with third-party tools are also available.

yUML class diagram – scruffy version

Nomnoml

The nomnoml web application is a simple editor with a live preview. It is purely client side and changes are saved to the browser’s localStorage, so your diagram should be here the next time (but no guarantees). You can also the nomnoml standalone javascript library to render diagrams on your own web page. Find the source code on GitHub.

nomnoml live editor

nomnoml live editor

TextUML

TextUML Toolkit  is an open-source IDE for UML to create models at the same speed you write code, therefore, offering increased modeling productivity. TextUML is compatible with all tools that support Eclipse UML2 models. TextUML offers all features you like in your favorite IDE: instant validation, syntax highlighting, outline view, textual comparison and live graphical visualization of your model as class diagrams

The TextUML Toolkit can be used both as a set of plug-ins for the Eclipse IDE, and as a part of a multi-tenant server-side application – as seen in Cloudfier.

While the last version dates from 2015, it remains a go-to tool for textual modeling within the Eclipse community.

TextUML example syntax for class diagrams. Render it with any Eclipse UML tool

UML Graph

UML Graph automatically renders class and sequence diagrams. For the class diagrams, it uses a Java-based syntax complemented with javadoc tags. Running the UmlGraph doclet on the specification will generate a Graphviz diagram specification. For sequence diagrams, UMLGraph uses a different approach (and this is one aspect I don’t like about the tool, you are basically working with two different tools here). Pic macros are used to define objects and method invocations. Then, the pic2plot program processes the macros to generate PNGs and other graphics formats. LightUML integrates UMLGraph in Eclipse. UMLGraph in GitHub.

UMLGraph example

Umple

Umple can also be used as a textual modeling tool for UML even it is aimed at a slightly different purpose: Umple merges the concepts of programming and modeling by adding modeling abstractions directly into programming languages.  Currently, Umple supports Java, PHP and Ruby as base languages. It adds UML attributes, associations and state machines to these languages.  Read our post on Umple for more details on the history and background of Umple.

UmpleOnline model editor

UmpleOnline model editor

ZenUML

ZenUML is one of the latest tools to enter the market. Read why the author believed that ZenUML was needed when there were already so many other textual tools for UML sequence diagrams. In short, creating sequence diagrams with ZenUML is really fast even for complex diagrams.

ZenUML editor for sequence diagrams

Chart Mage

Chart Mage enables the creation of flowcharts and sequence diagrams. As we describe here in more detail, the main feature of Chart Mage is its autocomplete functionality that makes a reasonable guess of what you’re going to write next based on the typical UML syntax and the partial model you’ve created so far.

Chart Mage in action: from text to flowcharts and UML sequence diagrams

USE

USE: UML-based Specification Environment  is a system for the specification and validation of information systems based on a subset of the Unified Modeling Language (UML) and the Object Constraint Language (OCL). As such, its goal is not simply to visualize the models but to help designers check the quality of their specifications. For instance, given a UML model you can ask USE to create and display a valid instantiation of that model to make sure the model definition is consistent.

Validating OCL constraints with the USE enviornment

Validating OCL constraints with the USE enviornment

Other alternatives (only for UML sequence diagrams)

WebSequencediagrams

WebSequenceDiagrams is an online editor for sequence diagrams.  You can save and export the diagrams and choose between alternative sequence diagram notations. Paid versions allow you to run a private version of the software.

WebSequenceDiagrams editor

SequenceDiagram.org

SequenceDiagram.org  is quite similar to the one above, both in functionalities and look and feel.

BlockDiag

BlockDiag and its family generate diagram images from simple text files following a syntax similar to graphviz’s DOT format. Among these diagrams, it supports UML activity and sequence diagrams. The tool is built in Python.

Swimlanes.io

Swimlanes is a simple online tool for creating sequence diagrams. Diagrams can be exported as an image file or a URL link to be embedded in your own documents.

swimlanes online editor for UML sequence diagrams

Sequins

The Sequins app allows you to quickly draw sequence diagrams while commuting or while you’re on the go. Diagram how pieces of a system interact with each other, then share it in any cloud- or social media-based app from your tablet or phone. Or save the image on your Android device for later use.

Draw uml digrams with your mobile phone

 

LaTeX to UML

Hardcore LaTeX fans have also a way to easily embed UML diagrams in their TeX files.

  • Latex macros for drawing UML Sequence diagrams , the name says it all
  • MetaUML is a “library for typesetting UML diagrams, using a human-friendly textual notation”. It currently supports class, activity and use case diagrams and state machines. Their main goal is to create UML diagrams readily usable in a LaTeX document
  • UML Diagrams with TikZ-UML. TikZ-UML is a TikZ extension to manage common UML diagrams: class diagrams, use case diagrams, state-machine diagrams and sequence diagrams. It produces beautiful UML diagrams in LaTeX
  • Even our good friend PlantUML has a LaTeX extension.

(and part of this “geek” category, we could also include this emacs mode for sequence diagrams).

Beyond UML diagrams

There’s life beyond UML. If you’re more into ER than UML (and I agree that ER has some good points), QuickDatabaseDiagrams  offers a textual notation to draw ER diagrams. Also Umple  (described above) supports the generation of ER visualizations.

Textual notation for ER

ERD is another option. It takes a plain text description of entities, their attributes and relationships and renders a graphical entity-relationship diagram. The visualization is produced with the help of Dot with GraphViz. ERD takes some inspiration from ERWiz that had the same goal but it’s now abandoned.

Dead modeling tools

Quite a few tools that were part in this list seem to be now dead or at least abandoned, like  SeedUMLEasyUML Editor Simple DSL for sequence diagrams , Diagrammr, Quick Sequence Diagrams Editor (only for sequence diagrams), modsl and even this code sample for Visual Studio that allowed describing class, use case and activity diagrams using simple textual descriptions (not updated since 2011).

 

 

Comments
  1. Timothy Lethbridge
  2. Jaime Olivares
    • Jordi Cabot
  3. Andrej

Leave a Reply

Your email address will not be published. Required fields are marked *

Pin It on Pinterest

Share This