Flowchart Editor — User Guide
Draw control flow with the symbols of JIS X 0121 (ISO 5807) and export it as a drawing for your specification, as Markdown, or as a review text for an AI — and build it automatically from a timing chart.
1. Overview
The Flowchart Editor places terminators, processes, decisions, waits and the other symbols and joins them with arrows. A new symbol is placed under the selected one and everything below moves down automatically, so a flow can be assembled quickly from the keyboard alone. Lines route themselves around the symbols, and you can tidy the few that need it by hand.
It runs entirely in the browser, and your data is saved only inside the browser on this machine. Nothing is sent anywhere.
2. Tutorial (your first flow)
- Click the “Start” terminator to select it and press Enter; a “Process” is added below. Type the text and press Enter to confirm.
- Shift+Enter adds a “Decision”, where you write a condition such as “Start button ON ?”.
- Drag the “NO” handle of the decision back onto the decision itself and you have a “wait until the condition is true” loop.
- Drag the exit handle of the last process onto “End” to close the flow.
- Ctrl+L arranges the drawing: the YES flow in one column, the NO flow in the column to its right.
- In “Output → Export…” (Ctrl+E) pick Markdown and press “Copy to clipboard”, then paste it into Notion or GitHub.
“Tutorial” in the Help menu loads the sample and walks you through the same steps on screen.
3. Symbols and connections
Clicking a symbol in the palette on the left adds it below the selected symbol; dragging it drops it wherever you like, and dropping it onto a line inserts it between two steps. Selecting a symbol shows its exit handle (○): drag that onto another symbol to connect them, or onto empty space to create a new process already connected. The YES / NO wording is switched for the whole chart with “Branch labels”, and each decision can override it.
For steps that run at the same time (closing a clamp while stopping a conveyor, for example), use “Parallel start” and “Parallel end” (the JIS double line for parallel processing). Select a parallel start to set the number of branches and where they go in the panel on the right; connecting the end of every branch to a parallel end means “continue only after all branches have finished”. “Arrange” widens the double lines across the branch columns so the lines run straight up and down.
4. Tidying a line by hand
Symbols are joined bottom-to-top, following the top-to-bottom reading of a flowchart. Only when the other symbol sits directly beside it — overlapping in height and clear of it left or right — are the two side edges joined straight across; a hand-over between swimlanes takes this form. The left and right vertices of a decision are its branch outputs, so no line is ever brought in there (its entrance is the top vertex).
Lines normally route themselves around the symbols. When one does not go where you want, drag the middle of it and that part moves sideways. The drag records waypoints on the line, and from then on the line is drawn through them instead of along the automatic route. Selecting a line shows its waypoints as □ / ■, which you can drag.
Double-click a waypoint, or drag the part you moved back onto the straight line, and the waypoints disappear and the automatic route returns. Right-clicking a line and choosing “Back to the automatic route” does the same, and auto-arrange (Ctrl+L) puts every line back.
5. Lanes and signal lines
When the work is split between two sides — a master and a slave, say — “Insert → Add a lane” gives each of them a vertical band (a swimlane). Dragging a symbol into another lane changes which side it belongs to. A signal handed from one side to the other is drawn as a signal line (a dotted arrow): drag the □ beside a symbol onto the symbol on the other side. A signal line means “the receiving side takes this as the trigger for its next step”.
6. Building it from a timing chart
This is the last of the four design tools (System Diagram → Memory Map → Timing Chart → Flowchart). “← Timing Chart” at the right of the toolbar goes back one step. After changing the timing chart, “Rebuild” regenerates this drawing with the same settings as before (anything you edited here is replaced, so save it first if you want to keep it).
Use “To Flowchart →” in the Timing Chart Editor, or load the JSON with “Build from a timing chart…”, and the flow is generated from the signal changes. A change of your own signal becomes a “process”; a change of the other side's signal becomes a “wait” (a decision or a wait symbol). If you drew cause-and-effect arrows in the timing chart, the order is built so that the cause is awaited before the resulting output changes, and in the side-by-side style the signal lines follow those arrows exactly. Changes with no arrow are laid out in step order.
7. Keyboard shortcuts
8. Output and saving
Everything you can export lives in one place: “Output → Export…” (Ctrl+E). Each format says where it is meant to be pasted, so you pick one and press “Copy to clipboard” or “Save to a file”.
- SVG: a white-background, black-line drawing for a specification. Save it to a file and bring it in with Insert → Picture in Word, Excel or PowerPoint, and the lines stay sharp however far you zoom.
- Image (PNG): copy it and paste it straight into Word, Excel, PowerPoint, an e-mail or a chat.
- Draw.io: symbols you can keep editing as shapes. Copy it and press Ctrl+V in the draw.io window. A drawing changed in draw.io cannot be loaded back into this editor, so change the symbols and arrows here and paste again.
- Markdown: the flowchart in Mermaid form with the list of steps and the signal hand-overs. GitHub and Notion render it as a picture.
- Mermaid: only the flowchart, as Mermaid code (.mmd) — the same diagram as in the Markdown.
- JSON: the format shared by all four tools — for feeding an AI or handing the data to the next tool.
If draw.io pastes it as plain XML text, add a new page with the + at the bottom left and choose Extras → Edit Diagram… on the menu bar (without the menu bar: + → Advanced on the toolbar). The box holds the XML of the current page: select it with Ctrl+A, paste, and press Apply. Apply replaces everything on the page, which is why a new page is used.
Your work is saved automatically in the browser, but press Ctrl+S to keep it as a JSON file.
A machine usually has several flowcharts, one per process. Use the “Flowchart ▾” list at the top to add, switch, duplicate and remove them. Once there are two or more (or when made from a chart with partitions), the “This machine” tree appears on the left and takes over the list (click a flowchart to switch to it; use ⋯ in its header to add, duplicate or remove; click a partition to make this a diagram of that partition). It also lists the system diagram, memory maps and timing charts of the same machine, and items marked ↗ open in their own tool. The tree, the symbols and the properties can be dragged by their headers to the top or bottom of the left or right column, into tabs with another panel, or into a new column beside it (also from ⋯). Once you use the list, New, Open and Create from timing chart keep the current chart in the list and add another one. “Save the whole list to a machine file…” puts them all in one file, and “Put all into the list” brings them back when you open a machine file.
For the thinking behind this kind of drawing — what belongs on one sheet and the pitfalls seen on site — see the guide How to draw a PLC control flowchart (in Japanese). All four editors are listed on the FA Spec Tools home page.
Please send bug reports and feature requests to yk.builds.space@gmail.com. Steps to reproduce the problem — and, if you can, the saved JSON file — make it much quicker to look into.