Documentation · Process
Gantt chart
Name the unit, open a section, then list its tasks: each starts in a unit or after other tasks, and lasts a whole number of units.
When to use it
Plan work over numbered weeks or months: tasks grouped in sections, how long each lasts, what each waits for, how much is done, and the milestones on the way.
Write a task that waits for another as after T1 rather than with a unit of its own; it then moves when the task before it does.
Working example
Copy this complete example into the Source tab, then press Generate. Change its labels or values to make your first version.
gantt "Thesis Schedule" {
unit "Week"
today 5
section "Proposal"
task T1 "Literature review" 1 3 done 100
task T2 "Write the proposal" after T1 2 done 60
milestone M1 "Proposal defence" after T2
section "Research"
task T3 "Build the prototype" after M1 4
task T4 "Collect the data" after T3 3
task T5 "Analyse the results" after T4 2
section "Writing"
task T6 "Write chapters 4 and 5" after T5 3
milestone M2 "Final defence" after T6
}Syntax reference
The same reference used by the editor and AI briefing. Syntax is notation-specific; use the keywords listed here.
Chart
| Syntax | Meaning |
|---|---|
gantt "Title" { | open a Gantt chart |
unit "Week" | what one numbered unit is called |
today 5 | a dashed line through the unit the chart is read in |
Tasks
| Syntax | Meaning |
|---|---|
section "Research" | a section; the tasks after it are listed under it |
task T1 "Survey" 1 3 | starts in unit 1, lasts 3 units |
task T2 "Write" after T1 2 | starts once T1 ends, lasts 2 |
task T3 "Test" after T1 T2 2 | starts once both have ended |
task T1 "Survey" 1 3 done 60 | 60% of it done |
milestone M1 "Defence" after T2 | a diamond where T2 ends |
milestone M2 "Launch" 12 | a diamond at the start of unit 12 |
Look
| Syntax | Meaning |
|---|---|
color "#2a78d6" | the colour every bar takes |
text 12 | caption size, 9 to 20 |
size 760 400 | width and height on the sheet |
Language rules
- The file is one gantt "Title" { ... } block. Nothing may sit outside it.
- Time is counted in whole units from 1 (week 1, week 2, …); unit only says what a unit is called.
- A task is task ID "Name", then either the unit it starts in or after the IDs it waits for, then how many units it lasts. It may end with done and a percentage.
- A milestone is milestone ID "Name" then a unit or after IDs; it lasts nothing and takes no done.
- section "Name" lists every task after it under that section, until the next section.
- Every ID after after is a task or milestone in the chart, and following them never loops back.
- Settings are written as name value, in any order.
- Do not invent settings. Every one the language has is listed above.
Edit on the canvas
- Drag a bar to move it and its right end to change how long it lasts; both snap to whole units.
- Rename a task or section in place, and add or remove tasks from the sheet or the Gantt panel.
Generate replaces the drawing from source. Save before generating again if you want to preserve manual finishing touches.
Read Saving & exportingWrite it with an assistant
Tingraph AI already knows this notation. For another assistant, copy the tutorial below, describe your diagram under MY DIAGRAM, then paste the returned source into the editor. This prompt includes every syntax row, rule and working example above.
Read the complete prompt
You are writing Tingraph source. Tingraph is a small text language that draws a Gantt chart. Answer with Tingraph source only.
SYNTAX
Chart
gantt "Title" { open a Gantt chart
unit "Week" what one numbered unit is called
today 5 a dashed line through the unit the chart is read in
Tasks
section "Research" a section; the tasks after it are listed under it
task T1 "Survey" 1 3 starts in unit 1, lasts 3 units
task T2 "Write" after T1 2 starts once T1 ends, lasts 2
task T3 "Test" after T1 T2 2 starts once both have ended
task T1 "Survey" 1 3 done 60 60% of it done
milestone M1 "Defence" after T2 a diamond where T2 ends
milestone M2 "Launch" 12 a diamond at the start of unit 12
Look
color "#2a78d6" the colour every bar takes
text 12 caption size, 9 to 20
size 760 400 width and height on the sheet
RULES
- The file is one `gantt "Title" { ... }` block. Nothing may sit outside it.
- Time is counted in whole units from 1 (week 1, week 2, …); `unit` only says what a unit is called.
- A task is `task ID "Name"`, then either the unit it starts in or `after` the IDs it waits for, then how many units it lasts. It may end with `done` and a percentage.
- A milestone is `milestone ID "Name"` then a unit or `after` IDs; it lasts nothing and takes no `done`.
- `section "Name"` lists every task after it under that section, until the next section.
- Every ID after `after` is a task or milestone in the chart, and following them never loops back.
- Settings are written as `name value`, in any order.
- Do not invent settings. Every one the language has is listed above.
WORKED EXAMPLE
gantt "Thesis Schedule" {
unit "Week"
today 5
section "Proposal"
task T1 "Literature review" 1 3 done 100
task T2 "Write the proposal" after T1 2 done 60
milestone M1 "Proposal defence" after T2
section "Research"
task T3 "Build the prototype" after M1 4
task T4 "Collect the data" after T3 3
task T5 "Analyse the results" after T4 2
section "Writing"
task T6 "Write chapters 4 and 5" after T5 3
milestone M2 "Final defence" after T6
}
OUTPUT
- Reply with one fenced code block and nothing else.
- The block starts with `gantt "…" {` and ends with `}`.
- Do not invent keywords: use only the ones listed above.
- Keep labels short enough to read inside a box, and keep every ID unique.
MY DIAGRAM
Describe what you want here, then send this message.Something unclear? Contact support or read the Privacy Policy.