Skip to content

Mind Mapping

Osmosis renders your markdown structure as a fully interactive mind map. Headings, bullet lists, and numbered lists become nodes. The map and your markdown stay in sync — edit one, and the other updates instantly.

Full-screen mind map view

How Markdown Maps to Nodes

Markdown Node Type
# Heading through ###### Heading Branch nodes (depth = heading level)
- Item or * Item Bullet list nodes
1. Item Numbered list nodes
Plain paragraphs Paragraph nodes
![[other-note]] Transcluded sub-branch

Nodes render rich content — bold, italic, code, images, and LaTeX all display inside map nodes.

Opening a Mind Map

Method How
Editor header Click the icon next to the reading view toggle
Command palette "Open mind map view"
File menu Right-click a file > "Mind map view"
Ribbon Click the icon in the left sidebar

Launch mind map from note view

Transclusion

Embed another note's content as a sub-branch using standard Obsidian syntax:

## My Topic
- Key point
- ![[detailed-notes]]

The embedded note's heading and list structure appears as a collapsible sub-branch. Transcluded branches are lazy-loaded — they only parse when expanded. Editing a transcluded node writes changes to the source file.

osmosis_mind_map_transclusion_split_view

Cursor Sync

When enabled (on by default), clicking a node scrolls the markdown editor to that line, and placing your cursor in the editor highlights the corresponding node.

Toggle in Settings > Osmosis > Cursor sync.

Touch Support

Osmosis works on Obsidian mobile:

Action Gesture
Pan Single finger drag on canvas
Zoom Pinch
Select Tap a node
Edit Double-tap a node
Context menu Long-press a node or canvas

Guides

  • Editing

    Add, delete, move, and restructure nodes with keyboard shortcuts and context menus

  • Navigation

    Keyboard navigation, selection, viewport controls, and collapse/expand

  • Styling

    Themes, node shapes, branch lines, per-map settings, and the style cascade