# Xmind Integrator

> Generates professional XMind (.xmind) files from Markdown plans, task lists, or Mermaid mindmap blocks. Use when you need to export a visual project roadmap or hierarchy to XMind.

- Skill: `claio0128/xmind-integrator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add claio0128/xmind-integrator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/claio0128/xmind-integrator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: claio0128 (https://skillmd.com/u/claio0128)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/claio0128/xmind-integrator

---


# XMind Integrator

This skill allows you to transform your local Markdown project plans and Mermaid diagrams into XMind files for high-level visual presentation.

## Workflows

### 1. Export Plan to XMind
If the user asks to "Export my plan to XMind" or "Generate an XMind map for this project":
1.  Locate the primary Markdown file (e.g., `plan.md`).
2.  Run the generation script:
    ```bash
    node xmind-integrator/scripts/generate_xmind.cjs <path_to_md_file>
    ```
3.  The script will automatically detect Mermaid mindmap blocks OR standard Markdown headers/lists to build the hierarchy.

## Technical Details
- **Library**: Uses the official `xmind` Node.js SDK.
- **Parsing**:
    - Prioritizes `mermaid mindmap` blocks for structure.
    - Falls back to Markdown headers (`#`, `##`) and lists (`-`, `*`) if no Mermaid block is found.
- **Output**: Generates a `.xmind` file in the same directory as the source Markdown file.

## Requirements
- `pip install xmind`