Skip to content
GitHub·

✍️reladraw: A New Text Language for Diagrams Without Installation

Draw Diagrams Without Installing Anything

TL;DR

reladraw is a text-based language for creating and modifying diagrams without needing to install anything. It's different from other tools like Mermaid, Graphviz, and D2, offering a middle ground between absolute positioning and auto-layout languages.

reladraw is a new text language for drawing diagrams without the need for installation. Unlike Mermaid, Graphviz, and D2, reladraw focuses on relative positioning, making it easier to modify existing diagrams without rebuilding them from scratch. This is a big deal for anyone working on complex diagrams that need frequent updates. The language is still in development, with a TypeScript parser, resolver, and SVG renderer already complete. It supports routing edges around nodes, drawing icons and shapes, and more, all without exact coordinates.

reladraw: A New Text Language for Diagrams Without Installation — GitHub

Key Points

1

reladraw uses a parser, resolver, and SVG renderer in TypeScript, no runtime dependencies needed.

2

The language supports minimal node-avoiding edge routing and machine-readable diagnostics from solved geometry.

3

reladraw can route edges around nodes and draw icons and shapes from path data inside the tool.

4

The language has a command-line tool that takes a text file and writes a standalone SVG.

5

reladraw's syntax is not stable and may change, but it's already usable for creating and modifying diagrams.

Why It Matters

If you're working with complex diagrams that need frequent updates, reladraw offers a unique solution. It allows you to modify diagrams without rebuilding them from the numbers, making it easier to keep diagrams up-to-date. The TypeScript-based parser, resolver, and SVG renderer ensure that the tool is lightweight and doesn't require any runtime dependencies.

reladrawdiagramstext-languagedeveloper-toolstypescript

Comments

Subscribe to join the conversation...

Be the first to comment

Enjoyed this article?

Get it daily. 7am. Free. Reads in 5 minutes.

Join 3,507 builders reading daily.

Also get