How to Create a Sequence Diagram Online with a Simple Text-Based Tool

You can create a sequence diagram online by typing plain text on the left side of the screen and watching the diagram render in real time on the right. Swimlanes.io works this way: it is a free webapp for making sequence diagrams, and the page states that you edit text on the left and the diagram updates live. This approach suits anyone who wants a sequence diagram quickly without dragging shapes around a canvas, and who is comfortable writing a few lines of simple syntax.

What a sequence diagram contains

A sequence diagram shows how participants interact over time. In a text-based tool, you express that with three basic elements:

  • Participants — the actors or systems exchanging messages, written as names such as One, Two, and Three.
  • Messages — the arrows between participants. In the example on the site, One -> Two: Message draws a message from One to Two, and Two -->> Three: _Notification_ uses a different arrow style for a notification.
  • Notes — annotations attached to the flow, written with note: followed by text, for example a note explaining what the diagram is for.

The order you write the lines in becomes the order of events, read from top to bottom.

Writing the diagram as text

The workflow is a loop: type, look at the preview, adjust.

  1. Name your participants. Start a line with the first participant, then the arrow, then the second participant, then a colon and the message text. For example, One -> Two: Message creates a message from One to Two.
  2. Add more interactions. Each new line adds another step. A participant can also send a message to itself, as in Two -> Two: To self.
  3. Annotate where useful. A line beginning with note: adds a note to the diagram, such as note: **swimlanes.io** is a simple online tool for creating _sequence diagrams_.
  4. Check the preview. The diagram on the right updates in real time as you edit, so you can confirm each change immediately.
  5. Look up syntax when you need more. The page links to a full syntax overview at /gallery/full-syntax for details beyond the basics.

Message text supports simple formatting: **bold**, _italics_, and backticks for code-style text such as `ok`.

Saving and sharing your diagram

There are two ways to keep or distribute a diagram, and they behave differently.

Method What happens Best for
Copy the URL The diagram is encoded in the URL. Note that the URL changes every time you update the diagram. Quick sharing of a single current version
Sign in Create an account and collect all of your diagrams in one place. Keeping and managing multiple diagrams over time

Because the URL changes on every edit, a link you copied earlier will not reflect later changes — copy the URL again after you finish editing if you want to share the latest version. The page also states you can download your sequence diagrams as images, which is useful when you need a static file rather than a link.

Common sticking points

  • Sharing a stale link. If you send a URL and then keep editing, the recipient sees the older version. Re-copy the URL after your final edit.
  • Forgetting the colon. Message text comes after a colon on the same line; without it, the line will not render as intended.
  • Assuming an account is required. You can build and share a diagram without signing in; the account is for collecting diagrams, not for basic use.
  • Expecting a fixed link. The live-updating URL is convenient but not stable, so treat it as a snapshot rather than a permanent address.

If your goal is a single diagram to paste into a document or chat, the text-plus-preview loop and an image download will get you there fastest. If you expect to build many diagrams and want them organized, signing in is the better fit.

swimlanes.io
Swimlanes.io is a simple free online tool for making sequence diagrams