mindmap

Text Mind Map Generator — Transform plain outlines and bullet lists into beautiful ASCII tree diagrams. Visualize your ideas, document structures, and hierarchies directly in the terminal.

Commands

Usage

# From a string (use \n for newlines)
bash script.sh create "Root\n  Branch A\n    Leaf 1\n    Leaf 2\n  Branch B"

# From a file
bash script.sh view my-outline.txt

# Export as Markdown
bash script.sh export my-outline.txt > mindmap.md

# Pipe from stdin
cat outline.txt | bash script.sh view -

Input Format

Use indentation (spaces or tabs) to define hierarchy. The first non-empty line is the root node.

My Project
  Frontend
    React
      Components
      Hooks
    CSS
      Tailwind
  Backend
    Node.js
    PostgreSQL
  DevOps
    Docker
    CI/CD

Requirements

• bash >= 4.0
• python3 >= 3.7
• No external packages required (uses only stdlib)

Examples

$ bash script.sh create "Learning Python\n  Basics\n    Variables\n    Functions\n  OOP\n    Classes\n    Inheritance\n  Libraries\n    NumPy\n    Pandas"

Learning Python
├── Basics
│   ├── Variables
│   └── Functions
├── OOP
│   ├── Classes
│   └── Inheritance
└── Libraries
    ├── NumPy
    └── Pandas

$ bash script.sh export outline.txt

```mindmap
My Project
├── Frontend
│   ├── React
│   └── CSS
└── Backend
    └── Node.js