Make flowcharts from text

flowchart Pirate's Code

(Sail Ho!) -> <Friend or Foe?>
  -friend-> [Check Logs~] -> /Trade Rum/ -> [Celebrate]
  -foe-> [Fire Cannons] -> [[Claim Loot]] -> [Celebrate]
[Celebrate]->(Sail On)

Overview

Flowcharts use an indent-based syntax with shaped nodes and labeled arrows. Nodes are created automatically from their shape delimiters — just write the flow and Diagrammo handles the layout.

Syntax

flowchart Chart Title
direction-lr

(Start) -> [Step] -> <Decision?>
  -yes-> [Action] -> (End)
  -no-> [Other Action]

Settings

Key	Description	Default
`chart`	Must be `flowchart`	Yes
`title`	Diagram title	None
`direction-lr`	Left-to-right layout (default is top-to-bottom)	off

Node Shapes

Each shape has its own delimiter syntax:

Shape	Syntax	Appearance	Typical Use
Terminal	`(Label)`	Rounded rectangle	Start / End
Process	`[Label]`	Rectangle	Actions / Steps
Decision	`<Label?>`	Diamond	Yes/No branching
I/O	`/Label/`	Parallelogram	Input / Output
Subroutine	`[[Label]]`	Double-bordered box	Reusable procedures
Document	`[Label~]`	Wavy-bottom box	Files / Reports

Arrows and Edge Labels

Connect nodes with ->. Add labels between dashes:

[A] -> [B]
[A] -yes-> [B]
[A] -no-> [C]

Branching with Indentation

Indent continuation lines to branch from a decision node:

<Valid?>
  -yes-> [Process] -> (Done)
  -no-> [Show Error] -> /Retry/

The indented lines connect back to the last node at the parent indent level, creating branching paths without explicit wiring.

Node Colors

Append a color name (lowercase) at the end of a node label:

(Start green) -> [Process blue] -> (End red)

The 11 recognized colors are: red, orange, yellow, green, blue, purple, teal, cyan, gray, black, white. To use one as a literal label, capitalize it (Red, Blue).

Comments

// This line is ignored by the parser
(Start) -> [Step] // inline comments are NOT supported

Complete Example

flowchart Color Demo

(Start green) -> [Parse Input] -> <Valid? blue>
  -yes-> [Process teal] -> (Success green)
  -no-> [Error Handler red] -> /Log Error orange/ -> (Failure red)