md2xmind

thanhtunguet's avatarfrom thanhtunguet

Use md2xmind to convert markdown tree structures to XMind mind map files. Converts hierarchical markdown bullet lists into .xmind format for use in mind mapping applications.

0stars🔀0forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The md2xmind skill is a powerful productivity tool designed to bridge the gap between structured text and visual brainstorming. It seamlessly converts hierarchical Markdown bullet lists into professional XMind (.xmind) files, preserving nested structures and indentation. By automating the transformation of text-based outlines into visual mind maps, it enables users to quickly visualize complex ideas, project roadmaps, and knowledge hierarchies without manual drawing.

Use Cases

  • Project Planning: Convert a project breakdown or WBS (Work Breakdown Structure) drafted in Markdown into a visual XMind roadmap for team presentations and alignment.
  • Knowledge Management: Transform structured study notes, research outlines, or book summaries into interactive mind maps to enhance memory retention and conceptual clarity.
  • Meeting Summaries: Turn hierarchical meeting minutes and action items into a visual hierarchy to better track dependencies and organizational structure.
  • Content Architecture: Map out the structure of complex technical documentation, website sitemaps, or book chapters starting from a simple Markdown list.
namemd2xmind
descriptionUse md2xmind to convert markdown tree structures to XMind mind map files. Converts hierarchical markdown bullet lists into .xmind format for use in mind mapping applications.

Markdown to XMind Converter Skill

Instructions

Use this skill when users need to convert markdown files with hierarchical bullet lists into XMind (.xmind) files.

Steps:

  1. Check if Python 3 is available:

    python --version
    

    If Python 3 is not installed, kindly inform the user: "This skill requires Python 3 to be installed on your system. Please install Python 3 and try again."

  2. Run the included md2xmind script to convert markdown to XMind:

    python ~/.claude/skills/md2xmind/references/md2xmind input.md output.xmind
    

    The command creates an XMind file from the markdown bullet structure.

    Available options:

    • --title TEXT: Set the title for the mind map (default: "Mind Map")

Input Format

The markdown file should contain hierarchical bullet lists using - markers:

- Root Topic
  - Subtopic 1
    - Detail 1
    - Detail 2
  - Subtopic 2
- Another Root Topic
  - More content

Features

  • Supports multiple root topics (creates wrapper if needed)
  • Handles both space-based (2 spaces per level) and tab-based indentation
  • Automatically removes hierarchical numbering (e.g., "1.2.3 Title" becomes "Title")
  • Creates valid XMind files compatible with XMind applications
  • Generates unique IDs for all topics
md2xmind – AI Agent Skills | Claude Skills