xmind2md

Convert XMind mind map files into hierarchical Markdown documents.

Updated Aug 27, 2026

Search Tags:#markdown #python #outline #conversion #hierarchy #mindmap #xmind

Ready to run

npx skills add https://github.com/thanhtunguet/agent-skills --skill xmind2md

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: xmind2md
Source: https://github.com/thanhtunguet/agent-skills/tree/main/xmind2md
Command: npx skills add https://github.com/thanhtunguet/agent-skills --skill xmind2md

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Many tools cannot read XMind files directly or preserve the map hierarchy for analysis and documentation, making it difficult to review, share, or repurpose mind maps as text outlines.

Core Features & Use Cases

Converts modern XMind (.xmind) files into a readable Markdown outline while preserving topic hierarchy and supporting multiple sheets.
Offers hierarchical numbering, configurable maximum depth, and sheet separation to tailor exports for notes, documentation, or content ingestion.
Use Case: Export a project planning mind map to Markdown for inclusion in documentation or to import into a note-taking workflow.

Quick Start

Convert the attached project-plan.xmind into a Markdown outline with hierarchical numbering enabled.

Frequently Asked Questions about xmind2md

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I convert an XMind file to Markdown while preserving the topic hierarchy?▼

Yes, the conversion supports multiple sheets within a single XMind file by applying sheet separation. It processes each sheet independently, allowing you to export complex mind maps into structured Markdown documents without losing distinct sheet content.

Can I limit the hierarchy depth when exporting an XMind mind map to a Markdown outline?▼

Yes, you can configure a maximum depth limit when exporting an XMind mind map to a Markdown outline. This restricts the hierarchy levels included in the final document, allowing you to focus on high-level topics and prevent overly nested text.

Do I need Python to extract content from an XMind file into a text outline?▼

Yes, you need Python 3 installed to extract content from an XMind file into a text outline. The conversion relies on a Python script to unpack the zip-style .xmind container and read the internal JSON data for hierarchical transformation.

Does the XMind to Markdown conversion support hierarchical numbering for documentation?▼

Yes, the XMind to Markdown conversion supports hierarchical numbering. This feature adds ordered numbering to the generated Markdown outline, making the exported mind map content easier to reference and analyze within technical documentation or notes.

What is the best way to import project planning mind maps into a note-taking workflow?▼

The best way to import project planning mind maps into a note-taking workflow is converting the .xmind files into structured Markdown. This transforms the visual map into a text outline, enabling seamless ingestion into documentation platforms that support Markdown.