md2hd
Start free

Turn markdown files into maps you can follow.

Your notes hold the facts. md2hd draws the relationships between them, so you can see what depends on what, who connects to whom, and where the gaps are.

Start freeView source77

Unlimited maps on Hosted Free. No card or deadline.

q3-launch.mdMarkdown
---
type: map
title: Q3 Launch
inverse: { reports_to: manages }
---

---
id: priya-raman
type: person
weight: lead
title: Priya Raman
subtitle: Engineering lead
reports_to: "[[platform-team]]"
rel:
  owns: q3-launch
---

---
id: tom-alvarez
type: person
title: Tom Alvarez
subtitle: Backend
reports_to: "[[platform-team]]"
rel:
  maintains: billing-service
---
Q3 LaunchMap
TEAMPlatform TeamEngineering · 6 peoplePERSONPriya RamanEngineering leadPERSONTom AlvarezBackendSERVICEBilling ServiceInvoices and renewalsPROJECTQ3 LaunchShips 30 Septemberreports toreports tomaintainsownsdepends on

Hover the text on the left to light up its card on the right. Color says what kind of thing it is; a heavier outline says it matters more.

How it works

Ask your agent to build the map.

Give the included skill to your AI agent. Point it at existing notes or describe what you need. The agent writes ordinary markdown, and md2hd draws it.

Add the md2hd skill

Add the skill folder to the agent you already use. It now knows the exact markdown md2hd can draw.

Your agentany tool that reads skills

Add the md2hd mapping skill to my workspace.

writing-md2hd-mapsagent skill · installed

Done. Describe anything, and I will write it as a map md2hd can draw.

Describe what you need to see

Point the agent at your notes or describe the subject. Ask for the people, systems, evidence, or events and the relationships between them.

Your agentwriting-md2hd-maps

Map our Q3 launch. Owners, blockers, dates. My notes are in the planning folder.

Read 12 notes. Writing the map now.

q3-launch.md14 cards · 19 links

Open the markdown in md2hd

Import the file or folder. The cards, connections, and notes open as one map. Edit the markdown later and the map redraws.

PROJECTQ3 LaunchPERSONPriya RamanOwns the dateBLOCKERLegal ReviewNew billing termsownsblocks

Get the AI skill, or build a small map by hand.

Large maps

Focus one card. Keep the context.

This live map covers San Francisco officials, departments, plans, and dependencies. Open any card to line up what points to it and what it points to. Open the background to return to the full map.

Use cases

Map the relationships your work depends on.

You name the kinds of things and the connections between them. The same format can map a partnership, a software system, a body of evidence, or a story.

Partnerships

Who actually moves the decision?

Map the people, the organizations around them, and the relationships that move the work.

See the workflow
ORGANIZATIONRiverside CouncilPERSONDana WhitfieldCity ClerkPROGRAMOpen Records Portalemploysowns

Systems

What breaks when this changes?

Map services, queues, owners, and the old system that everything still depends on.

See the workflow
SERVICECheckout APIQUEUEPayments queueDATASTORELedgerNo API, no ownerpublishes todepends on

Research

Which evidence supports the claim?

Map sources to claims, then follow the evidence that supports or challenges each conclusion.

See the workflow
CLAIMResponse times roseSOURCEFOI responseObtained 12 MaySOURCEBudget hearingsupportsundercuts

Writing

Who knows what, and when?

Map characters, secrets, and the plot threads that must meet before the story ends.

See the workflow
CHARACTERMaraKnows by ch. 4BEATThe false identityCHARACTERJonasdiscoverslies to

Ownership

The markdown remains the record.

Keep using your editor, backups, and git history. md2hd adds a map without replacing the files that produced it.

Your files stay yours
Import markdown and export markdown. Your editor, backups, and git history keep working.
Hosted Free keeps unlimited maps
Store as many maps as fit within 100 MB. There is no card or deadline. Delete a map when you no longer need it.
Yours to run
The complete application is MIT licensed. Run it on infrastructure you control and operate its storage, accounts, and sharing rules yourself.
The map draws in your browser
Parsing and drawing happen on your screen. When you use the hosted service, saved markdown is stored so your maps remain available across devices.

The honest limits are written down too. See what md2hd does with data and what it deliberately does not do.

Pricing

Choose where your maps live.

Self-host the complete application, use Hosted Free, or add Pro for public links, up to ten people, and 1 GB of hosted storage.

See pricing

Open your markdown as a map.

Start with the sample maps, then import a folder of your own.

Start freeRead the quickstart