# 🗺️ Note Minimap — A Minimap View for Obsidian Notes

Note Minimap adds a minimap panel inside your Obsidian editor pane, giving you a scaled-down visual overview of the entire note. Inspired by modern code editors, this plugin helps you **navigate long markdown files faster** and with more spatial awareness.

## ✨ Features

- 🔎 **Live minimap view** of the current note - supports all view modes
- 🖱️ **Draggable viewport slider** to scroll instantly
- 🌓 Supports all themes
- 💠 Automatically updates on scroll and content change
- 🔁 Per-note toggle button in the note header
- 📏 Resizes automatically with the pane

## 📸 Screenshot

![Screenshot of Obsidian with active minimaps.](/screenshot.png)

## 🚀 Getting Started

### 📦 Installation

You can install Note Minimap in **three** ways:
#### 1. From the Community Plugins Browser (Recommended!)

- Open Obsidian
- Go to `Settings` → `Community Plugins`
- Disable Restricted Mode
- Click `Browse` and search for `Note Minimap`
- Click `Install` and then `Enable`
#### 2. Manual Installation

- Download the latest release from [GitHub Releases](https://github.com/YairSegel/ObsidianMinimap/releases)
- Extract into your Obsidian `.obsidian/plugins/minimap` folder
- Make sure the folder includes:
  - `main.js`
  - `manifest.json`
  - `styles.css` (optional)
#### 3. Clone Directly (For Developers)

```bash

git clone https://github.com/YairSegel/ObsidianMinimap .obsidian/plugins/note-minimap

```

## 🧪 Usage

1. Install & enable the plugin.
2. Open any markdown note.
3. A minimap will appear on the right edge of the editor.
4. Scroll & write in the editor — the minimap updates live.
5. Drag the slider in the minimap to jump to different parts of the note.
6. Click the `Toggle Minimap` button in the upper-right corner of the pane to choose whether to show minimap.

## ⚙️ Settings 

- Adjustable minimap scale
- Enable minimap by default
- Opacity (separate for minimap and slider)
- Top offset (for custom toolbars in the note)

## 📌 Limitations

- Doesn't have settings yet
- Doesn't support custom themes yet
- Not optimized for extremely large notes yet
- Uses workaround to render long notes because of Obsidian's lazy loading  

## 💡 Ideas and Contributions

Contributions, bug reports, and feature requests are welcome!  
Feel free to open an [issue](https://github.com/YairSegel/ObsidianMinimap/issues) or submit a pull request.