MindFlow

by auroraechop
5
4
3
2
1
Score: 51/100

Description

Turn any Obsidian note into an editable, radial mind map -- same tab, same file, no new files ever created.

Reviews

No reviews yet.

Stats

2
stars
1,017
downloads
0
forks
64
days
7
days
4
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
48
commits

Latest Version

4 days ago

Changelog

更新内容 / What's changed

折叠与导航 / Folding and navigation

  • Z 聚焦一支分支。 选中卡片按 Z,导图以它为根重新排布、其余分支收起,几百张卡的图变成读得过来的一支;再按一次 Z,或点路径行开头新多出的「整张导图」一步,整张图连同原来的视角一起回来。它只是看的方式:笔记、折叠、撤销栈一个字都不动,也不跨会话记住;聚焦的卡片被删掉或改得认不出来时,聚焦自己结束。Z zooms into a branch. With a card held, the map lays itself out from that card as its root and puts every other branch away -- a few hundred cards become one branch you can actually read. The same key again, or the Whole map step the path row now starts with, brings the map back with its camera. It is a way of standing, nothing more: the note, the folds and the undo stack are untouched, nothing is remembered between sessions, and a zoomed card that is deleted or rewritten past finding ends the zoom by itself.

卡片与块 / Cards and blocks

  • 网页链接可以直接拖进导图。 从浏览器拖一个链接、或者把地址栏里的网址拖到卡片上,落点下面就多一张外部链接卡片:名字用你拖的那个链接的文字,地址栏拖来的用站名(www. 去掉),卡片直接把站点卡片展开 —— 站名、完整地址、在浏览器打开的按钮。和笔记卡片一样是链接,改名、拖动、删除、撤销都照常;一次拖动算一步撤销,落空白处挂到根节点下。只认 http/https,obsidian://、mailto: 仍不收。A web link can be dragged straight onto the map. Drag a link out of a page, or the address out of the address bar, and a link card appears where it landed: named by the link's own words, or by the site (www. dropped) when the drag carried none, with its site card already open -- the site's name, the full address and a button that hands it to the browser. It is a link like any other card, so rewriting it, dragging it, deleting it and undoing that all work as usual; the whole drag is one undo step, and empty canvas puts it under the root. Only http/https are taken -- obsidian:// and mailto: are still refused.

Full changelog: 2.0.3...2.0.4

安装 / Install

手动安装: 把下方的 main.js、manifest.json、styles.css 下载到

<your vault>/.obsidian/plugins/mindflow/

然后在 设置 → 第三方插件 中启用 MindFlow。 (或者下载 mindflow.zip,解压到 .obsidian/plugins/ 下,一个文件搞定。)

BRAT: 把 AuroraEchop/MindFlow 添加为 beta 插件。

Manual: download main.js, manifest.json and styles.css below into the folder above, then enable MindFlow in Settings → Community plugins. (Or download mindflow.zip and unzip it into .obsidian/plugins/ -- one download instead of three.)

BRAT: add AuroraEchop/MindFlow as a beta plugin.

用法 / Use it

打开一篇笔记,在命令面板里运行 Toggle mind map view —— 给它绑一个快捷键, 用起来就像切换阅读模式。导图在同一个标签页、同一个文件上打开,不会创建任何文件。

Open a note and run Toggle mind map view from the command palette — assign it a hotkey to make it feel like switching reading mode. The map opens in the same tab, on the same file. No files are ever created.

Built from 2.0.4 with tests and typecheck passing.

README file from

Github

MindFlow

中文说明 | Usage guide | Development

Turn any Obsidian note into an editable, radial mind map — the same way you switch to reading mode. Same tab, same file, no new files ever created.

Every edit you make on the map is written straight back into the original .md note as a minimal line edit. Toggle back and your note is still your note.

[!TIP] Got an idea, or something that feels wrong? Open an issue — a feature you wish it had, a rough edge, a note it draws badly. Most of what this plugin does now started as one of those.

MindFlow


Highlights

  • A view mode, not an export. Toggling swaps the view type on the leaf you are already in, so the same TFile stays open in the same tab. Nothing is generated, copied, or written to a sidecar file.
  • Your outline is the map. Headings nest by level; nested bullets hang under the heading they belong to. What you already wrote is the structure.
  • Edit on the canvas, in place. Rename, add, delete, indent, drag to reparent, drag to reorder, fold, tick checkboxes — no dialogs, no modal editors. Text fields open right on the card.
  • Annotations. A line written as : text under a heading or a bullet hangs under that node's card in muted text instead of becoming a card of its own.
  • Pictures and videos drawn on the card. ![[hero.png]] is the picture itself, and a video is a still frame with two buttons on it — one plays it in place, the other hands it to Obsidian's own player. Paste a picture onto a card and it is filed in your vault and drawn there; paste an image's address and it is read once and kept. In an exported SVG, PNG or HTML the pictures are inlined, so the file shows them anywhere.
  • A card that points at another note opens where it stands. Its title carries two buttons: one shows what that note says — rendered as markdown, samples and tables and pictures included — and one brings its outline in as a subtree under the card, drawn with dashed connectors. A link written inside your prose previews on the card it was written on, and a link that leaves the vault gets a card naming the site. None of it opens a new tab, and none of it writes a single file.
  • Three card styles. Bordered, rounded, or minimal — the last draws nothing at rest and frames a card only while you are editing it.
  • Curved or right-angled connectors, four toolbar dock positions, and a corner toolbar that can hide itself until you pick a card.
  • Reopens where you left it. Fold state and focus are remembered per note, in the plugin's own data — never in your markdown.
  • One undo history per note. The markdown editor and the map share a single stack, so Ctrl+Z walks back through both.
  • Nothing else is touched. Frontmatter, fenced code, tables, HTML and links are never reformatted. Lines you did not edit come back byte-for-byte identical, including CRLF endings.

Screenshots

Editing in place, annotations, card styles, dragging, the shortcuts settings page and the find bar

Install

From the community plugin browser. In Obsidian, open Settings → Community plugins → Browse, search for MindFlow, press Install, then Enable. That is the whole of it — Obsidian offers you each new version from then on.

By hand, if you would rather have the files yourself:

  1. Download main.js, manifest.json and styles.css from the latest release;

  2. Copy them into your vault:

    <your vault>/.obsidian/plugins/mindflow/
    
  3. Enable MindFlow in Settings → Community plugins.

Or download mindflow.zip from the same release and unzip it into .obsidian/plugins/ — one download instead of three.

Either way you need Obsidian 1.5.7 or later.

Use it

Open a note and run Toggle mind map view from the command palette — assign a hotkey to make it feel like switching reading mode.

Key Action
Enter / Tab New sibling / new child
Ctrl/Cmd+Enter Add or edit the annotation
Shift+Enter Add a text block
Delete Delete the node and its children
Space Fold / unfold
Z Zoom into the selected branch, and back out
Ctrl/Cmd+Z Undo
Ctrl/Cmd+F Find in the map

Hold Space and drag to pan the canvas from anywhere — over a card and the text on it included, without selecting a word of it.

Every key is rebindable, and the settings page warns when two actions end up on the same one. The full list, the editing gestures, the settings reference and the export formats are in the usage guide.

Documentation

Document What it covers
Usage guide (中文) Every gesture, the full shortcut table, the shortcuts settings page, annotations, content cards, search, export, all settings
Development (中文) Architecture, module map, the round-trip invariant, how to add a shortcut or a setting, testing, releasing

Development

src/model/     parser + mutation engine — pure functions, no Obsidian imports
src/layout/    tidy-tree layout
src/view/      canvas, cards, connectors, interactions, math, the TextFileView
src/main.ts    plugin: view registration, the mode toggle, commands

src/model and src/layout have no DOM or Obsidian dependency, which is why they can be unit-tested directly with node --test (Node 22.6+ strips the TypeScript types natively — no build step, no test framework).

npm install
npm run dev      # watch build, straight into the plugin folder
npm run build    # typecheck + production bundle
npm run check    # version + changelog + typecheck + 555 tests + build

Before a release, also run the review's own rule set:

npm --prefix tools/obsidian-lint install   # once; it keeps its own dependencies
npm run lint:obsidian                      # see docs/Development.md §9

See docs/Development.md for the architecture, the core invariant, and how to add a shortcut, a setting or an export format.

Derived from obsidian-mindmap-mode by PHANTOM-Nw — v1.1.1, MIT licensed.

License

MIT — see LICENSE. Copyright (c) 2026 AuroraEchop.

No third-party code is bundled: there are no runtime dependencies, formulas are typeset by Obsidian's own MathJax, and icons come from Obsidian's setIcon.

XMind, MindNode and Mubu are trademarks of their respective owners; this project is not affiliated with either and mentions them only to describe how the canvas behaves. Obsidian is a trademark of Dynalist Inc.