View XMind files in Obsidian and connect to XMind software for editing.

View XMind mind maps directly in Obsidian with full interactive features

Seamlessly embed XMind files in your notes using simple markdown syntax

• 📖 File Viewing: View XMind mind maps directly in Obsidian
• 🔗 Software Connection: One-click connection to XMind software for editing
• 📄 Note Embedding: Embed XMind files in Markdown using ![[file.xmind]] syntax
• ⚡ Seamless Workflow: Smooth workflow between viewing and editing
• 🖼️ Thumbnail Preview: Auto-extract thumbnails for quick preview
• 🌐 Multi-Language: Support for English and Simplified Chinese interface

1. Open Obsidian Settings
2. Go to Community Plugins → Browse
3. Search for "XMind Linker"
4. Install and enable the plugin

1. Download the latest release files
2. Extract to Obsidian plugins directory: {vault}/.obsidian/plugins/xmind-linker/
3. Enable the plugin in Obsidian settings

1. Clone the repository to plugins directory
2. Install dependencies and build

# Clone repository
git clone https://github.com/leafney/obsidian-xmind-linker.git

# Enter directory
cd obsidian-xmind-linker

# Install dependencies (using Bun)
bun install

# Build plugin
bun run build

• Double-click .xmind files in Obsidian file explorer

# My Mind Map

Here's an embedded XMind file:

![[my-mindmap.xmind]]

Click to preview or hover for action options.

When thumbnail extraction is enabled, the plugin automatically extracts thumbnails from XMind files for direct use in Markdown:

![[my-mindmap.xmind]]

• Hover over embedded files for quick actions
• Click "Open in XMind" to launch external editor
• Return to Obsidian to view after editing in XMind

Configure in Obsidian Settings → Plugin Options → XMind Linker:

• Language: Choose interface language (English/简体中文) with automatic detection
• System Integration: Enable connection to XMind software
• Hover Actions: Display action menu on hover
• Thumbnail Cache: Auto-extract thumbnails for faster preview

• XMind file parsing: Native support for .xmind format (ZIP-based)
• System integration: Cross-platform XMind software invocation
• Interactive preview: Full preview powered by xmind-embed-viewer
• Smart caching: Thumbnail extraction and caching mechanism

• Node.js 16+
• Bun 1.0+
• Obsidian 0.15.0+

# Install dependencies
bun install

# Development mode (watch file changes)
bun run dev

# Build production version
bun run build

# Run tests
bun test

For maintainers who need to publish new versions:

1. Create and push tag (triggers automatic build):

   # 推荐使用不带 v 前缀的标签格式（符合 Obsidian 官方要求）
   git tag 1.1.0
   git push origin 1.1.0

2. Wait for GitHub Actions to complete the build and create the release

3. Update repository manifest using the provided script:

   ./update-version.sh 1.1.0

This process ensures that:

• The release is automatically built and published
• The repository's manifest.json is updated for Obsidian Plugin Store compatibility
• Users can download updates through Obsidian's plugin manager

1. Enable developer tools in Obsidian: Ctrl+Shift+I
2. Check console output for plugin status
3. Use console.log for debugging

• xmind-embed-viewer - Xmind Core preview functionality
• Obsidian - Powerful knowledge management tool
• Cursor - AI-powered code editor that provided powerful development support for this project
• obsidian-xmind-viewer - Excellent open-source project that provided valuable design insights and technical inspiration

If you encounter issues or have suggestions:

1. Check Issues
2. Create a new Issue
3. Join the discussion

• Feature Overview - Detailed feature descriptions and screenshots
• 中文文档 - Chinese documentation
• Installation Guide - Detailed installation instructions
• Usage Guide - Comprehensive usage documentation
• Deployment Guide - Development and deployment guide

This project is licensed under the MIT License - see the LICENSE file for details.

Enjoy using XMind mind maps in Obsidian! 🎉