Niches · Diagramming

Write a diagram as code and render it for a doc, README or PR

Two or three companies' docs show a full fit.

3companies, full fit
8companies, fit with a limit
18companies carry the tag
22share of the category's work
11first-hand accounts

What counts as done

Diagram source committed or embedded as text, plus an SVG or PNG that renders without a parse error and shows every node and edge in the source, produced from the source alone.

Measured, for our own tests: one render call under 5 seconds for a 30-node diagram. No docs we read state these figures, so they don't count against a listing here.

How agents ask for it: add a sequence diagram to the README, render this Mermaid as PNG, make a PlantUML diagram for the proposal, draw the schema as an ERD

Does the job 3

The docs show it meets the test above, and nothing we read says otherwise.

ListingWhy
D2 B
The Hack Foundation (Hack Club), fiscal sponsor of the D2 project
The local CLI renders .d2 text to SVG, PNG, PDF, PPTX, GIF or ASCII from stdin to stdout with automatic layout, and TALA is now bundled free. The man page says to trust the exit status, since a partial file can be written on error. Speed bar not stated. source
Kroki C
Yuzu tech, a French software firm. No registered legal form found
POST /<type>/<format> with the diagram text returns SVG, PNG or PDF for about 29 formats, self-hosted from Docker with SECURE safe mode by default; acc-06 renders locally from Claude Code. Speed bar not stated; acc-04 needed several rounds of TikZ fixes. source
Mermaid Chart MCP F
Mermaid Chart Inc.
validate_and_render_mermaid_diagram validates Mermaid text and returns PNG and SVG with a playground link; a free account is enough. Rendering is hosted, not local (acc-09 used mermaid-cli for that). Speed bar not stated. source

Does the job, with a limit 8

It does the job, but something in the docs or a user's account will get in an agent's way. The limit is named in each row.

ListingWhy
AI Diagram Maker MCP E
AI Diagram Maker (Rajasekar Elango)
generate_diagram_from_mermaid converts Mermaid to D2 and returns a PNG, but the conversion passes through AI and credits, the agent's own source isn't rendered as written, and it is hosted only. source
draw.io + MCP B
draw.io Ltd
Source is draw.io XML or Mermaid text, but PNG, SVG and PDF come only from the plugin with draw.io Desktop's CLI installed; the hosted server and tool server return links, not images. source
Eraser API + MCP F
Eraser Labs, Inc.
Eraser's own diagram-as-code is text the agent keeps, and export_diagram returns PNG, JPEG, SVG or PDF. Rendering is hosted only, and whether a syntax error fails the call or renders is not documented. source
ExcaliClaw D
ExcaliClaw
Mermaid text in, export_design gives PNG or SVG, but only Mermaid's structure is read, rendering is hosted only, and the terms couldn't be read because they render by script. source
Excalidraw C
Excalidraw s.r.o.
The CLI renders a local .excalidraw file to PNG or SVG in under a second with Chrome, and excalidraw mermaid turns Mermaid into SVG. Only some Mermaid types become shapes, the rest a static image, and acc-03 found the look too rough. source
Lucid API + MCP B
Lucid Software Inc.
Mermaid text goes in and the export endpoint returns PNG, JPEG or SVG of one page by Accept header, but rendering is hosted only, and an invalid body is a generic 400 with no line. source
PlantUML B
No legal entity found. Copyright Arnaud Roques
java -jar plantuml.jar --svg -pipe renders text locally to SVG, PNG or PDF and exits above 0 on a syntax error. Without --no-error-image a bad diagram still writes an image of the error, and the default LEGACY profile lets !include read files and URLs. source
Structurizr + MCP B
Structurizr Limited
The DSL is text and MCP exports views to Mermaid, PlantUML or C4-PlantUML text, which then need a second renderer. PNG and SVG come from a separate export command or a self-hosted server, since the cloud service closed. source

Doesn't do this job 6

Listings in the category that do something else, with the reason.

ListingWhy
Cloudviz API F
SIA Cloudviz Solutions
No diagram text input; it renders from a scanned AWS account. source
Diagrams.so API + MCP B
RedHold LLC
Input is prose, not diagram code the agent keeps; there is no text source to commit and render. source
Mumble F ours
tiny space
No diagram text language to commit and render; the canvas is JSON and images come from the app's PNG or PDF export. source
Mural MCP F
Tactivos, Inc. (d/b/a Mural)
A whiteboard with no diagram-as-code format or text source to commit. source
tldraw SDK + MCP C
tldraw, Inc.
No text diagram format or headless render; image export runs in the editor in a browser. source
Whimsical MCP D
Whimsical, Inc.
Whimsical's syntax lives inside its boards; export is a PNG snapshot through fetch, with no SVG or source file to commit. source

What stops agents finishing

  • syntax error rendered as an image of the error with a success status
  • public render instance with no terms for private diagrams
  • layout engine needs a paid licence

Around it

Before: code.read-repo. After: code.open-pr, docs.write.

Where this comes from

Weight 22 of 100 in Diagramming: 11 of 37 accounts (Mermaid, D2, PlantUML, Kroki, Structurizr export); what most HN users say they do day to day

The same as data: /api/v1/use-cases/diagramming.render-as-code.json, or the MCP tool get_use_case with id diagramming.render-as-code. Other jobs in this category: /api/v1/niches?category=diagramming.

Draft, read 2026-11-15 from public docs and first-hand accounts, not yet reviewed by a person. A mark says what the docs show, not what a run measured.

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.