Local-first. Plain text. Keyboard-first.

Structured thinking that still lives in normal Markdown files.

mdmind is built for mind maps, outlines, plans, story writing, research trees, and large structured sets of notes. It also comes paired with the mdm CLI for validation, search, export, and examples.

brew brew tap dudash/tap; brew install mdmind
Apache 2.0 Free macOS, Linux, Windows
mdmind screenshot showing the main outline and focus layout in the terminal
mdmind screenshot showing inline reading mode with attached notes
mdmind screenshot showing the visual mindmap view
Why mdmind

Plain-text maps without giving up structure, navigation, or editing power

mdmind keeps your work in normal Markdown-like files, then layers on focused views, ids, cross-links, search, validation, and a full-screen editor when the tree gets large.

Map language

Tags, metadata, ids, and cross-links inside plain text

Use #tags for grouping, @key:value for structure, [id:...] for stable deep links, [[target]] for references, and | details for longer notes attached to a branch.

Navigation

View modes, section jumps, and backlink-aware navigation

Work in Full Map, Focus Branch, Subtree Only, or Filtered Focus, jump by major branch through the command palette’s section index, and move through lateral structure with outgoing links and backlinks.

Search

Search, browse, and reopen working sets

Search by text, browse existing tags, metadata, and ids, reopen saved working sets, and use recipes when you know the workflow but do not want to remember the filter.

Outliner modes

Reading mode, minimal mode, and visual mindmap

Switch from a fuller guided surface to a quieter expert layout, expand long-form notes inline, and open the current scope as a visual map when the tree needs a second lens.

Agent-friendly

Built for agent-generated maps

mdmind gives agents a small, explicit vocabulary for hierarchy, details, ids, tags, and cross-links. You can also install mdmind skills for Codex and Claude so generated maps open cleanly and use the format on purpose. Install the skill pack.

Focused views

Large maps stay navigable without becoming a mess.

Full Map, Focus Branch, Subtree Only, and Filtered Focus give you different working scopes over the same file. The command palette can also jump by major branch through the section index when the map gets large.

mdmind screenshot showing the main outline and focus layout
Reading mode

Long-form notes stay attached to the branch they belong to.

Reading mode expands detail content inline instead of turning the outline into a separate editor. That makes writing, research, scene notes, and rationale feel natural without losing structure.

mdmind screenshot showing inline reading mode with attached notes
Second lens

Visual maps are there for looking at the structure differently

The visual mindmap follows your current scope and view mode. Use it for cluster recognition, presentations, and understanding branch shape.

mdmind screenshot showing the visual mindmap view
TUI + CLI

One map file. Two strong surfaces.

  • mdmind is the editor - with navigation, search, views, inline help, and visual maps.
  • mdm is a tool - validates, quick view, see data, exports, and more.
  • Both operate on the same plain-text file format.
Open and free

Apache 2.0 licensed and fully local-first.

  • No hosted dependency required.
  • No subscriptions ever.
  • Normal files, Git-friendly workflows, and open code.
Support the project

If you find mdmind useful, show your support

Get started

Download the latest release or install with Homebrew.

The downloads page points to the latest GitHub release and the current install paths for macOS, Linux, Windows, and local development.