We are taught that to make a diagram, we must use a mouse. But for a Textsmith—especially one who values accessibility and speed—the mouse is a blunt instrument.

The Power of Mermaid

Imagine writing three lines of text and getting a professional flowchart in return. This is Mermaid.js. By defining a simple logic like A --> B, we create a visual that is version-controlled, searchable, and instantly editable.

Why Markup Visuals Matter

  1. Consistency: Every arrow and box is perfectly aligned by the engine.
  2. Accessibility: Since the ‘source’ is text, Orca can tell me exactly what the diagram represents. A PNG is a black box; a Mermaid block is a story.
  3. Portability: Your diagrams live inside your Markdown or Typst files. No more ‘Missing Image’ errors.

Drawing is for artists; defining is for Smiths.


Forged in the terminal. Refined under the anvil.