Who it is forA team lead or operations owner who wants an org chart or service dependency map built from notes they already keep.

The problemGeneric diagram tools need separate data entry, and the notes describing the structure drift out of date.

The outcomeA map of your chosen types, with each relationship reading in the voice of its node, such as employs and works at.

What you need first

Node.js and npm installed, so that npx works
A markdown file or a folder of markdown notes
A modern web browser

Steps

Add a type: map block at the top of a markdown file, with a title and an inverse entry for each relationship pair.
Give each node a frontmatter block with an id, a type, a title, and a rel: list.
Run npx md2hd notes/ to open the map in the browser.
Click the Code toggle in a node's pane and edit the source file to watch the map redraw.

Prompt for your agent

Using the md2hd repo at evan-steinhilb/md2hd, write a type: map block and node frontmatter for the org chart described in <placeholder>. Expected output: markdown files with an inverse entry such as works_at: employs. Verify by running `npx md2hd <placeholder>` and checking that the relationship labels read correctly on both nodes.

Caveat. Md2 HD reads your own type names and labels from the files, so the map is only as clear as the types and inverse pairs you write.

Use this in your AI agent

Ask your agent

Using the Deduped MCP, get the setup steps for evan-steinhilb/md2hd and "Draw an org chart or service map with your own types"

Add Deduped to Claude Code once

claude mcp add --transport http deduped https://dedupedai.com/mcp

Cursor, ChatGPT, others

Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer

What you need first

Steps

Prompt for your agent

Use this in your AI agent

Run the default town and inspect it in the dashboard

Compile your notes into a searchable Markdown wiki

Save a Bilibili or YouTube video as Markdown notes