Chapters
Choose a chapter from the left panel or create a new one.
KrysML.com โ System & Process Capture
30 Sept 2026 - v5.0.1.1
29 Sept 2026 - v5.0.1.0
22 Sept 2026 - v5.0.0
Syntax, examples, and practice notes
KrysML (Krystyon's Modelling Language) is a simple, plain-text modelling language for describing systems.
KrysML is a structured way to take notes or jot down ideas, and this app (KrysML.com) lets you turn what you've written into diagrams oriented around what you need to communicate.
There are a few simple rules you need to follow to turn your notes into diagrams, and this guide explains them all.
# Block Diagram
10. THESE: KrysML.com
- Header
- Left Panel
- Centre Panel
- Right Panel
- Footer
000. START: launch KrysML.com @user ~browser
10. DO: select project name @user~header
# Default is "New Project"
20. DO: triple click @user ~header
30. DO: type new name @user ~header
40. DO: create/edit diagrams @user ~right_panel
50. IF: finished
- YES: save project @user ~header
- NO: continue working @user
LOOP TO 40
999. END: close tab/window @user ~browser
# Cycle
10. Create
20. Read
30. Update
40. Delete
# - loops back to 10
10. Create
# Interface Diagram
10. HAPPY: Server ~KrysML.com
# - Delivers app over network to user's browser
20. HAPPY: Network
30. HAPPY: User's browser
40. HAPPY: User's data
# - Data stays with user locally
30. HAPPY: User's browser
| Element | Format | What it does |
|---|---|---|
| Number + dot | 10. | Every step starts with a number and a dot. Mandatory. |
| Keyword | DO:, IF:, THESE:, START:, END:, HAPPY:, SAD:, MERGE:, PROCESS: | Optional. Sets the node shape. A step with no keyword renders as a plain blue rectangle. |
| Colon | DO: etc. | Mandatory on all keywords except LOOP TO. |
| Branch dash | - something | Under an IF or THESE. Defaults to Yes. |
| Explicit branch | - YES: - NO: |
Both need the colon. Indented under the parent step. |
| Implicit decision | ...something? | A trailing ? works instead of IF:. |
| Loop | LOOP TO n | Returns to step n. No colon. |
| Case | any case | START:, Start:, start: all valid. |
| Branch numbers | auto (40a, 40b) | Generated by the parser. Don't write them. |
@actor for people, ~system for systems. Use them when the actor is intrinsic to the step; use a separate chapter when it isn't.# at the start of a line disables it. // and <!-- --> also work. Pick one style and stick with it.? can replace IF:. PROCESS: and DO: are interchangeable.KrysML.com โ System & Process Capture
KrysML (Krystyon's Modelling Language) is a simple, plain-text modelling language for creating process, relationship, and interface diagrams, as well as basic flow charts.
KrysML.com is a single-file, offline-compatible, open-source tool that turns KrysML into diagrams. It's a free tool that
will always be available to everybody.
KrysML.com exists to put automation into the hands of people who don't code, whilst protecting the privacy of their work.
While there is value in the items on the right, I value the items on the left more.
Use Ctrl+S (or Cmd+S) to save the page. Open in a private/incognito window if you don't need to save what you are working on.
As the owner of KrysML.com, I hold myself to the standards of the profession I trained in:
This follows the IET Rules of Conduct and the Engineering Council's Statement of Ethical Principles.
โ Kris Martin, ICTTech TMIET
KrysML.com โ System & Process Capture
"KrysML.com makes no external network requests. No data is sent, stored, or processed outside your browser. Everything you create stays on your device until you choose to save or export it. This app does not use cookies, analytics, or tracking."
KrysML.com โ System & Process Capture
"KrysML.com is provided 'as is' without warranty of any kind. You are responsible for backing up your own data and for how you use the tool. The author is not liable for any loss of data or for any decisions made based on diagrams produced by this tool."
MIT License
Copyright (c) 2026 Kris Martin
Permission is hereby granted, free of charge, to any person obtaining a copy of this software
and associated documentation files (the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial
portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.