Skip to content

springrain1/obsidian-xmind-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SuperMind - Enhanced Mind Map Plugin for Obsidian

A powerful, stable mind mapping plugin for Obsidian

Interactive Editing • AI Smart Expansion • Multiple Export Formats • Enterprise-Grade Stability

Version Platform

中文文档


✨ Key Highlights

🎯 Complete Mind Mapping Experience

  • Native Obsidian Integration: Seamlessly integrates into your Obsidian workflow
  • Bidirectional Markdown Sync: Real-time conversion between mind maps and Markdown
  • 13 Professional Themes: Professional themes + dopamine color schemes for various scenarios
  • Rich Text Support: Tables, Callouts, quotes, code blocks, embedded content

🤖 AI-Powered Enhancement

  • Multiple AI Services: OpenAI, Anthropic, Gemini, Deepseek, Ollama
  • Smart Expansion: One-click child node generation, deep analysis, content optimization
  • Insight System: Flomo-like AI insights with multi-dimensional analysis
  • Custom Prompts: Fully customizable AI interactions

🏗️ Enterprise-Grade Stability

  • Unified Resource Management: Centralized resource lifecycle control
  • Zero Memory Leaks: Complete lifecycle management and automatic cleanup
  • Async Safety: Prevents race conditions accessing destroyed objects
  • Optimized Performance: Efficient rendering and memory usage

🎨 Rich Export Options

  • Image Export: PNG, JPEG, SVG with watermarks and author info
  • Document Export: Selected content export, 12 professional templates
  • XMind Integration: Bidirectional conversion with XMind files (Desktop)

🚀 Core Features

1. Mind Map Editing

Interactive Editing

  • ✅ Create and edit mind maps directly in Obsidian
  • ✅ Support for drag-and-drop, hotkeys, context menu
  • ✅ Real-time preview, WYSIWYG
  • ✅ Complete undo/redo history

Layouts and Styles

  • 4 Layout Directions: Center, Right, Left, Clockwise
  • 13 Themes: 7 professional + 6 dopamine color schemes
  • Custom Color Groups: Smart node connection color system
  • Responsive Canvas: Auto-adapts to content size

Rich Text Rendering

Content Type Supported Features
Markdown Formatting Bold, italic, highlight, strikethrough, code
Tables Full table rendering and editing
Callouts Multiple Callout types, theme-adaptive
Block Quotes Block quotes, text block display
Code Blocks Syntax highlighting, rendered as child nodes
Embedded Content Canvas, PDF++, Eagle, Excalidraw
Internal Links Support for internal link navigation
Footnotes Superscript rendering, content protection
Task Lists Clickable checkboxes

2. View Enhancements

Outline View

  • Tree structure display
  • Real-time search and quick navigation
  • Expand/collapse support
  • Synchronized scrolling with main view

Map Overview

  • Thumbnail minimap
  • Visual navigation
  • Quick jump
  • Real-time updates

Quick Settings

  • One-click theme switching
  • Adjust layout direction
  • Modify color groups
  • Background color picker

3. AI Features

Node AI Expansion (Plus Feature)

  • Generate Ideas: AI brainstorming
  • Generate Analysis: Deep content analysis
  • Detailed Expansion: Refine node content
  • Practical Applications: Practical scenario suggestions
  • Custom Prompts: Fully customizable

Context Menu AI

  • Popup with streaming output
  • Support for editing and insertion
  • Smart Callout type selection
  • Regenerate and replace functionality

File AI Analysis

  • Document analysis and summary
  • Keyword extraction
  • Streaming output to new file
  • Custom save path

AI Insight System

  • Multi-dimensional perspective analysis
  • Customizable built-in perspectives
  • Backlink expansion depth configuration
  • Persistent data storage

AI Skills System (Plus Feature)

  • Extensible AI workflows defined via SKILL.md
  • Multiple output formats: markdown, mermaid, excalidraw, canvas, base
  • Auto-scans vault skills/ folder to discover skills
  • Streaming output, real-time file writing
  • Smart content extraction, strips AI explanatory text

Unified Save Path Management

  • Three modes: custom path / vault root / source file directory
  • Shared across all AI features
  • Auto-creates directories when they don't exist

AI Stop Button

  • Both AI Insight and Skills execution support interruption
  • Mobile progress indicator integrates stop button
  • Mind map node AI expansion also supports stopping

Plus Feature Licensing

  • Trial Period: 7 days free trial for all Plus features
  • Licensing: Obtain registration code through sponsorship
  • Scope: Node AI expansion, context menu AI, file AI analysis
  • Free Features: All other features remain unrestricted after trial

4. Export and Publishing

Image Export

Supported Formats: PNG, JPEG, SVG
Features:
- Adjustable image width
- Custom author info (avatar, name, extra text)
- Watermark settings (text/image, transparency, rotation)
- 12 professional templates
- Mobile share menu integration

Document Export

Features:
- Selected content export
- Full document export
- Card summary display
- Filename and date control
- Export preview modal

XMind Integration (Desktop)

  • Markdown ↔ XMind conversion
  • XMind file preview (thumbnails)
  • Folder auto-sync
  • Open XMind in tabs

5. Collapse State Persistence

  • Uses <!--c--> comment markers
  • Compatible with obsidian-workflowy-plugin
  • Markdown view synchronization
  • Auto-save state

📱 Platform Support

Desktop (Full Support)

  • ✅ Windows, macOS, Linux
  • ✅ All features available
  • ✅ XMind integration
  • ✅ File system operations

Mobile (Basic Support)

  • ✅ iOS, Android
  • ✅ Mind map viewing and editing
  • ✅ Touch operations
  • ✅ Image export (share menu)
  • ✅ Tab/Enter virtual buttons
  • ⚠️ Not Supported: XMind conversion, file sync

📖 User Guide

Quick Start

1. Create Mind Map

Method 1: Ctrl+P → Search "Create new mind map"
Method 2: Right-click folder → "New mind map"

2. Open Existing File

Method 1: Right-click Markdown file → "Open as mind map"
Method 2: Command palette → "Toggle markdown or mindmap mode"

Keyboard Shortcuts

Node Operations
Shortcut Function
Shift+F2 Edit node
Shift+Insert Insert child node
Alt+Shift+Enter Add sibling node / End editing
Shift+Delete Delete node and children
Escape Cancel editing
Alt+Shift+S Select node text
Alt+Shift+D Move next siblings as children
Alt+Ctrl+Shift+D Move all siblings as children
Alt+Shift+J Join with node below
Alt+Ctrl+Shift+J Join as citation with node below
Node Movement
Shortcut Function
Alt+Shift+↑ Move node up
Alt+Shift+↓ Move node down
Alt+Shift+← Move node left
Alt+Shift+→ Move node right
Expand/Collapse
Shortcut Function
Alt+↓ Expand one level
Alt+↑ Collapse one level
Alt+PageDown Expand one level from max displayed
Alt+PageUp Collapse one level from max displayed
Ctrl+Shift+Space Toggle expand/collapse
Text Formatting
Shortcut Function
Alt+Shift+B Bold
Alt+Shift+I Italic
Alt+Shift+H Highlight
Alt+Shift+2 Strikethrough
Alt+Shift+L Remove line breaks
Other Operations
Shortcut Function
Alt+Shift+C Copy node
Alt+Shift+V Paste node
Alt+Shift+Z Undo
Alt+Shift+Y Redo
Alt+Ctrl+Shift+Z Replace with previous text
Alt+E Center current node
Alt+Shift+E Center entire map
Ctrl++ / Ctrl+Scroll↑ Zoom in
Ctrl+- / Ctrl+Scroll↓ Zoom out
Ctrl+0 Reset zoom

AI Configuration

  1. Set Up AI Service

    • Open plugin settings → AI Service Configuration
    • Select provider (OpenAI, Gemini, Deepseek, etc.)
    • Enter API Key and model name
  2. Use AI Expansion

    • Click the 🧠 button on a node
    • Or Ctrl+Double-click the node
    • Select expansion method
  3. Custom Prompts

    • Plugin settings → AI Custom Prompts
    • Use {{nodeContent}} placeholder
    • Takes effect immediately after saving

🛠️ Installation

Using BRAT (Recommended)

BRAT (Beta Reviewers Auto-update Tester) allows you to install and automatically update plugins directly from GitHub.

  1. Install the BRAT plugin from Obsidian Community Plugins
  2. Enable BRAT in Settings → Community plugins
  3. Open BRAT settings and click "Add Beta plugin"
  4. Enter the repository URL: https://github.com/springrain1/obsidian-xmind-plugin
  5. Click "Add Plugin" and BRAT will install SuperMind automatically
  6. Enable SuperMind in Settings → Community plugins

Tip: BRAT will automatically check for updates and notify you when a new version is available.

Manual Installation

  1. Download the latest release from Releases
  2. Extract to: <vault>/.obsidian/plugins/obsidian-xmind-plugin/
  3. Restart Obsidian
  4. Enable plugin in Settings → Community plugins

🔄 Latest Version

v2.8 - Mind Map View Enhancements & Format Improvements

  • ✨ Mind map view now renders node tables with support for child nodes under table nodes
  • ✨ Fixed rendering of Callout, table, code block, and quote block components; block-level components preserved as renderable child nodes
  • 🐛 Fixed blank line removal between components when writing back to Markdown, fixed note blank line loss
  • 🐛 Fixed content hierarchy misalignment after adding new nodes and converting to Markdown
  • 🐛 Fixed blank line issues between same-level unordered lists after list conversion
  • 🤖 New skill: xmind-mdoutline-generator - Extract mind map outline from original text, automatically add XMind-specific components

v2.7 - XMind Conversion Settings & Bug Fixes

  • ⚙️ Three save path modes for XMind → Markdown attachments: Obsidian default/original file location/custom path
  • 🐛 Fixed mouse drag inertia issue in canvas overview
  • 🐛 Added context window token count configuration option in AI service settings
  • 🐛 Fixed notes and --- separator loss issues
  • 🐛 XMind→Markdown note formatting optimization using more stable <strong> / <em> syntax

v2.6 - Batch Conversion & Comprehensive Format Support

  • 🔄 File list supports folder right-click or Alt multi-select for batch XMind ↔ Markdown conversion
  • ✨ Comprehensive format support: colors, notes, tags, summaries, boundaries, collapse states, formulas, images, floating topics, multiple sheets
  • ✨ New command to convert between "Level 1-3 headings + unordered lists" and "All unordered lists"

v2.5 - Settings Page Redesign

  • ✨ Two-level tab navigation layout for settings (General/AI/License), no more endless scrolling
  • ✨ Dopamine purple gradient navigation bar, light/dark theme compatible
  • ✨ Lazy-loaded tab content panels with tab state memory
  • 🐛 Fixed BASE view AI Insight unable to retrieve filtered documents (adapted to Obsidian's updated DOM structure)

📖 See Full Changelog


💬 Feedback & Support

If you encounter any issues or have suggestions:

  • Submit an Issue on GitHub
  • Describe the problem in detail with steps to reproduce

🙏 Acknowledgments

  • Obsidian Community
  • XMind Team
  • All users and supporters

Made with ❤️ for Obsidian

About

一款obsidian xmind&ai 思维导图插件

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors