xmind2md

thanhtunguet's avatarfrom thanhtunguet

Use xmind2md to read and process XMind mind map files by converting them to markdown format, enabling analysis and manipulation of hierarchical mind map content. Use it for all files that end with `.xmind` extension.

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

When & Why to Use This Skill

The xmind2md skill enables Claude to seamlessly read and process XMind mind map files by converting them into structured Markdown format. This tool bridges the gap between visual brainstorming and text-based analysis, allowing for the extraction, manipulation, and integration of hierarchical mind map data into documentation, project plans, and knowledge bases.

Use Cases

  • Project Documentation: Convert complex XMind brainstorming sessions into structured Markdown files for easy integration into GitHub READMEs, wikis, or internal documentation.
  • AI-Driven Analysis: Enable Claude to summarize, critique, or expand upon visual mind maps by providing a text-based hierarchical representation of the content.
  • Content Outlining: Transform visual ideas and structures into clean Markdown outlines to jumpstart the writing process for blogs, reports, or technical papers.
  • Task Management: Extract hierarchical nodes from .xmind files with numbered prefixes to create organized task lists and action items for project tracking.
namexmind2md
descriptionUse xmind2md to read and process XMind mind map files by converting them to markdown format, enabling analysis and manipulation of hierarchical mind map content. Use it for all files that end with `.xmind` extension.

XMind File Reader Skill

Instructions

Use this skill when users need to read or process 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 xmind2md script to read XMind file and output as text:

    python ~/.claude/skills/xmind-file-reader/references/xmind2md /path/to/file.xmind
    

    The command outputs the mind map structure in markdown format to stdout.

    Available options:

    • --numbers: Prefix bullets with hierarchical numbers (1.2.3)
    • --max-depth N: Limit depth (1 = root only)
    • --sheet-sep TEXT: Separator between sheets (default: blank line)