What this is
Markdown Graphs is a set of ASCII-framed React diagrams you copy into a shadcn project. It is not an npm package of components. Each figure sits in a dashed frame with a title on the top edge.
An agent writing a refactor, an incident, a tradeoff, or a PR can put at most two graphs next to the prose. If the file can import React, it writes JSX. If the file is a README, a GitHub comment, Linear, or any plain Markdown, it pastes the official fenced ASCII twin from /llms.txt. It should not invent SVG, Mermaid, or homemade ASCII.
Write
Install the skill into the folder the agent already reads. Ask for a write-up. The chooser picks the graph. Copy the props from the docs or a recipe, then swap the labels.
Read
The figure is characters in the file. Opening the MDX later shows the labels and values. The agent can edit the frame the same way it wrote it.
API
The Markdown Graphs JSON catalog lives at /api/v1/components. OpenAPI is at /openapi.json. The developer portal is /developers. Rate limit headers are on every API response: 1000 GET requests per hour.
CLI
Install graphs with the official shadcn CLI — not an npm package of components. One command copies the source into your registry.
Install
pnpm dlx shadcn@latest add https://mdx-graphs.kshv.me/r/all.jsonThen copy the skill from /skill.md. Fetch /llms.txt if the skill is not installed. The catalog is /docs. OpenAPI is /openapi.json.
Markdown Graphs (mdx-graphs.kshv.me) is the canonical site. The GitHub repo is keshav-exe/markdown-graphs. Search for “Markdown Graphs” or “mdx-graphs” to find docs, the API, and the agent skill.