Markmap Forge — Development skill for Claude Code

markmap-forge

Turn an outline into one standalone, interactive mind map. A small typed JSON file goes in, a single HTML file built on [markmap](https://markmap.js.org) comes out, and a validator checks the input first.

The output is deterministic: the template is a static asset and a Node.js CLI fills it in, validates and escapes the content, so the same JSON always gives the same bytes. That makes it safe to drive from an AI agent: the model writes the outline, never the HTML. [`SKILL.md`](./SKILL.md) is the ready-made instruction file for that use, a Claude Code skill that tells an agent how to turn a document into the JSON and call the CLI.


*The document above is `examples/example.html`, produced by the CLI from `examples/example.mindmap.json`. Regenerate the screenshot with `npm run capture:preview` so it never drifts from the template.*

Every output is a single self-contained HTML file: no build step, no script fetched at view time (it opens offline and behind corporate web filters), with search, level folding, pitch mode, dark mode, palette/font/size controls, an in-page markdown editor that regenerates the tree, and SVG/PNG export built in.

Install

Needs Node.js 18 or later. Run it without installing anything:

npx markmap-forge render input.json output.html

or install it globally with `npm install -g markmap-forge`. To work on the code, clone this repository and run `npm install`.

CLI

markmap-forge validate  [--json]
markmap-forge render  [output.html] [--json]
markmap-forge deliver  [output.html] [--json]

From a clone, run `node bin/markmap-forge.mjs` in place of `markmap-forge`.

`deliver` validates, renders, and prints a SHA-256 receipt for both the JSON source and the HTML artifact.

Input shape

See [`s