{
  "data": null,
  "kind": "anchor.page",
  "links": {
    "api": "https://www.anchorterminal.com/api/v1/index.json",
    "html": "https://www.anchorterminal.com/niches/diagramming.validate-diagram/",
    "json": "https://www.anchorterminal.com/niches/diagramming.validate-diagram/index.json",
    "llms": "https://www.anchorterminal.com/llms.txt",
    "markdown": "https://www.anchorterminal.com/niches/diagramming.validate-diagram/index.md",
    "mcp": "https://www.anchorterminal.com/mcp",
    "slim": "https://www.anchorterminal.com/niches/diagramming.validate-diagram/index.min.md"
  },
  "markdown": "Two or three companies' docs show a full fit.\n\n| Companies, full fit | With a limit | Carry the tag | Share of the category's work | First-hand accounts |\n| --- | --- | --- | --- | --- |\n| 2 | 7 | 16 | 14 | 8 |\n\n## What counts as done\n\nA pass or fail with a nonzero exit or error object on failure, naming the line or element at fault, and for layout checks a list of overlapping boxes, overflowing labels and dangling edges, all without publishing anything.\n\nMeasured, for our own tests: under 2 seconds per diagram.\n\nHow agents ask for it: check this Mermaid is valid; lint the diagram; does this render; validate the C4 workspace in CI\n\n## Does the job\n\nThe docs show it meets the test above, and nothing we read says otherwise.\n\n- **ExcaliClaw (ExcaliClaw)**: validate_design dry-runs a write with nothing saved, every write is rejected whole when it fails the gate and the response lists each error, and lint_design lists overlaps, arrows crossing boxes, text overflow and unbound arrows. Speed bar not stated.\n- **PlantUML (No legal entity found. Copyright Arnaud Roques)**: --check-syntax checks without generating images, exit is above 0 on error, and -stdrpt prints errors as single lines naming the line and file, suitable for CI. No overlap or dangling-edge check, which only matters for layout lint. Speed bar not stated.\n\n## Does the job, with a limit\n\nIt 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.\n\n- **D2 (The Hack Foundation (Hack Club), fiscal sponsor of the D2 project)**: d2 validate checks a file and the CLI's exit status reports failure, but there is no layout check for overlaps or dangling edges, and the maintainer declined a linter for models (acc-29).\n- **Diagrams.so API + MCP (RedHold LLC)**: get_warnings returns Well-Architected findings and fix_warning applies one, but there is no syntax check, no overlap or dangling-edge list, and no exit code.\n- **draw.io + MCP (draw.io Ltd)**: Diagrams are auto-repaired, and a layout check (overflowing labels, overlapping shapes, lines through shapes) is on staging per the maintainer on acc-19, not yet on mcp.draw.io. No syntax check with a nonzero exit or line number.\n- **Excalidraw (Excalidraw s.r.o.)**: check_scene_layout reports text sticking out and overlaps as layoutIssues without rendering, and writes return warnings. This is an MCP call on a workspace scene, not a CLI with an exit status for CI.\n- **Kroki (Yuzu tech, a French software firm. No registered legal form found)**: A bad diagram fails the request, with JSON errors on request; error type and line number in the JSON are unreleased on main. No layout check for overlaps or dangling edges.\n- **Mermaid Chart MCP (Mermaid Chart Inc.)**: A validation tool exists, but the docs don't show the error shape or whether it names the failing line, and there is no layout check. acc-30 shows Mermaid parse traps (parentheses in labels).\n- **Structurizr + MCP (Structurizr Limited)**: validate returns OK or an error message, inspect lists violations, and inspect's exit-0-on-violations bug (acc-26) was fixed in 2026.10.26. The docs don't say whether validate's error names the line.\n\n- not this job: AI Diagram Maker MCP (AI Diagram Maker (Rajasekar Elango)): No validation tool.\n- not this job: Cloudviz API (SIA Cloudviz Solutions): No diagram validation.\n- not this job: Eraser API + MCP (Eraser Labs, Inc.): No validation or lint tool is listed.\n- not this job: Lucid API + MCP (Lucid Software Inc.): No validation endpoint; a bad request returns a 400 without naming the line, and nothing checks layout.\n- not this job: Mumble (tiny space): A canvas with unresolved references is refused with the reason and tool errors come back as values, but there is no validator or lint for diagram source in CI.\n- not this job: Mural MCP (Tactivos, Inc. (d/b/a Mural)): No validation of diagram text, which it doesn't use.\n- not this job: tldraw SDK + MCP (tldraw, Inc.): No syntax or layout check.\n- not this job: Whimsical MCP (Whimsical, Inc.): No syntax or layout check tool.\n\n## What stops agents finishing\n\n- validator exits 0 on failures\n- no linter, so the model iterates blind\n\n## Around it\n\nBefore: diagramming.render-as-code, diagramming.editable-diagram. After: code.open-pr.\n\n## Where this comes from\n\nWeight 14 of 100 in Diagramming: 8 of 37 accounts (Kroki, D2, Structurizr, Excalidraw, draw.io lint scripts) plus Mermaid Chart's validate tool\n\nAs data: https://www.anchorterminal.com/api/v1/use-cases/diagramming.validate-diagram.json, or the MCP tool get_use_case with id diagramming.validate-diagram. Draft, read 2026-11-15 from public docs and first-hand accounts, not yet reviewed by a person.\n",
  "meta": {
    "attribution": "Anchor Terminal (https://www.anchorterminal.com)",
    "attributionRequired": true,
    "credit": "CC BY 4.0, credit Anchor Terminal and link the page or API address you took it from (https://www.anchorterminal.com/terms/#data)",
    "docs": "https://www.anchorterminal.com/docs/",
    "generatedAt": "2026-11-16",
    "license": "CC-BY-4.0",
    "method": "https://www.anchorterminal.com/benchmark/",
    "methodology": "0.8",
    "openapi": "https://www.anchorterminal.com/openapi.json",
    "preview": false,
    "run": "2026-10-01",
    "runLabel": "October 2026 research run",
    "terms": "https://www.anchorterminal.com/terms/#data"
  },
  "page": {
    "breadcrumbs": [
      {
        "name": "Home",
        "url": "https://www.anchorterminal.com/"
      },
      {
        "name": "For agents",
        "url": "https://www.anchorterminal.com/agents/"
      },
      {
        "name": "Niches",
        "url": "https://www.anchorterminal.com/niches/"
      },
      {
        "name": "Check a diagram parses and reads cleanly before publishing",
        "url": ""
      }
    ],
    "description": "Check a diagram parses and reads cleanly before publishing: 2 companies fully do it, 7 with a limit, 16 carry the tag. Every listing in Diagramming with the reason and a source.",
    "facts": null,
    "h1": "Check a diagram parses and reads cleanly before publishing",
    "image": "https://www.anchorterminal.com/assets/og/default.png",
    "path": "/niches/diagramming.validate-diagram/",
    "published": "",
    "section": "agents",
    "title": "Check a diagram parses and reads cleanly before publishing | Anchor…",
    "toc": null,
    "updated": "2026-11-15",
    "url": "https://www.anchorterminal.com/niches/diagramming.validate-diagram/"
  },
  "tokens": {
    "markdown": 1350,
    "slim": 330
  },
  "version": 1
}
