Skip to content

Diagrams

A diagram in Jotstak is a few lines of text. You write the structure; the page draws it. Because it is text in the same file as the prose, it changes when the prose changes, in the same edit, instead of going stale in another tool.

BlockDrawsGood for
@treeA hierarchy, from indentationGoals, features, org charts, taxonomies
@matrixA 2×2 with named axesEffort against impact, any two-way sort
@timelineEvents along a lineMilestones, a launch sequence
@journeyStages, and how each one feltUser journeys, onboarding
@star_modelOne thing in the middle, related things around itData models, stakeholder maps

A tree is indented lines. The same lines can be drawn four ways, and switching is one setting, not a redraw:

@tree dir=down nodes=boxed
  Retention
    Onboarding
      First value
    Habit loop
  • Retention
    • Onboarding
      • First value
    • Habit loop
  • no setting: an outline, like a nested list with lines
  • dir=down nodes=boxed: a chart, top to bottom, each node in a box
  • dir=right: columns, one level per column
  • dir=split: a map, balanced either side of the centre

You never size a diagram. It starts in the text column; if it is too wide for that it takes the full width of the page; if it is still too wide it shrinks a little, and if it would have to shrink further it gets a sideways page of its own. It is never cut off. To choose for yourself, set width to column, full or landscape.

A table is the exception: its words stay the size of the words around it, and its cells wrap instead.

On a phone the page stops being a sheet of paper and takes the width of the screen, and diagrams fit themselves to that.