Files
Fu-Jie_openwebui-extensions/plugins/actions/smart-mind-map
Copilot 272245d911 docs: add OOpenWebUI official newsletter featured recognition to Smart Mind Map, Markdown Normalizer, and Prompt Plus (#52)
* Initial plan

* docs: add OpenWebUI official newsletter featured recognition

- Add newsletter featured callout to Smart Mind Map README.md, README_CN.md, and docs
- Add newsletter featured callout to Markdown Normalizer README.md, README_CN.md, and docs
- Add newsletter featured badge to Prompt Plus in root README.md and README_CN.md
- Reference both newsletters: Jan 28, 2026 and Feb 3, 2026

Co-authored-by: Fu-Jie <33599649+Fu-Jie@users.noreply.github.com>

* docs: fix newsletter links to match actual featured issue per plugin

- Smart Mind Map: link only to Feb 3, 2026 (second newsletter)
- Markdown Normalizer: link only to Jan 28, 2026 (first newsletter)
- Prompt Plus (root READMEs): already correct, no change needed

Co-authored-by: Fu-Jie <33599649+Fu-Jie@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Fu-Jie <33599649+Fu-Jie@users.noreply.github.com>
2026-02-26 13:12:13 +08:00
..

Smart Mind Map - Mind Mapping Generation Plugin

Smart Mind Map is a powerful OpenWebUI action plugin that intelligently analyzes long-form text content and automatically generates interactive mind maps, helping users structure and visualize knowledge.

Author: Fu-Jie | Version: 1.0.0 | Project: OpenWebUI Extensions | License: MIT

🏆 Featured by OpenWebUI Official — This plugin was recommended in the official OpenWebUI Community Newsletter: February 3, 2026

What's New in v1.0.0

Direct Embed & UI Refinements

  • Native Multi-language UI (i18n): The plugin interface (buttons, settings, status) now automatically adapts to your browser's language setting for a seamless global experience.
  • Direct Embed Mode: Introduced a native-like inline display mode for Open WebUI 0.8.0+, enabling a seamless full-width canvas.
  • Adaptive Auto-Sizing: Mind map now dynamically scales its height and perfectly refits to the window to eliminate scrollbar artifacts.
  • Subdued & Compact UI: Completely redesigned the header tooling bar to a slender, single-line configuration to maximize visual rendering space.
  • Configurable Experience: Added ENABLE_DIRECT_EMBED_MODE valve to explicitly toggle the new inline rendering behavior.

Key Features 🔑

  • Intelligent Text Analysis: Automatically identifies core themes, key concepts, and hierarchical structures.
  • Native Multi-language UI: Automatic interface translation (i18n) based on system language for a native feel.
  • Interactive Visualization: Generates beautiful interactive mind maps based on Markmap.js.
  • Direct Embed Mode: (Optional) For Open WebUI 0.8.0+, render natively inline to fill entire UI width.
  • High-Resolution PNG Export: Export mind maps as high-quality PNG images (9x scale).
  • Complete Control Panel: Zoom controls, expand level selection, and fullscreen mode within a compact toolbar.
  • Theme Switching: Manual theme toggle button with automatic theme detection.
  • Image Output Mode: Generate static SVG images embedded directly in Markdown for cleaner history.

How to Use 🛠️

  1. Install: Upload the smart_mind_map.py file in OpenWebUI Admin Settings -> Plugins -> Actions.
  2. Configure: Ensure you have an LLM model configured (e.g., gemini-2.5-flash).
  3. Trigger: Enable the "Smart Mind Map" action in chat settings and send text (at least 100 characters).
  4. Result: The mind map will be rendered directly in the chat interface.

Configuration (Valves) ⚙️

Parameter Default Description
show_status true Whether to display operation status updates.
LLM_MODEL_ID gemini-2.5-flash LLM model ID for text analysis.
MIN_TEXT_LENGTH 100 Minimum text length required for analysis.
CLEAR_PREVIOUS_HTML false Whether to clear previous plugin-generated HTML content.
MESSAGE_COUNT 1 Number of recent messages to use for generation (1-5).
OUTPUT_MODE html Output mode: html (interactive) or image (static).
ENABLE_DIRECT_EMBED_MODE false Enable Direct Embed Mode (Open WebUI 0.8.0+ native layout) instead of Legacy Mode.

Support

If this plugin has been useful, a star on OpenWebUI Extensions is a big motivation for me. Thank you for the support.

Troubleshooting

  • Plugin not working?: Check if the action is enabled in the chat settings.
  • Text too short: Ensure input text contains at least 100 characters.
  • Rendering failed: Check browser console for errors related to Markmap.js or D3.js.
  • Submit an Issue: If you encounter any problems, please submit an issue on GitHub: OpenWebUI Extensions Issues

Technical Architecture

  • Markmap.js: Open-source mind mapping rendering engine.
  • PNG Export: 9x scale factor for print-quality output (~1-2MB file size).
  • Theme Detection: 4-level priority detection (Manual > Meta > Class > System).
  • Security: XSS protection and input validation.

Best Practices

  1. Text Preparation: Provide text with clear structure and distinct hierarchies.
  2. Model Selection: Use fast models like gemini-2.5-flash for daily use.
  3. Export Quality: Use PNG for presentations and SVG for further editing.

Changelog

See the full history on GitHub: OpenWebUI Extensions