Skip to content

cyber-rye/obsidian-margin-markers

Repository files navigation

Margin Markers

An Obsidian plugin that places visual markers in the editor gutter when a collapsed heading or block contains an emoji you care about — so you can see what needs attention without expanding every section.

Think of it like breakpoints in a code editor, but for your notes.

How it works

Write emojis inside headings or bullet blocks as attention signals. When you collapse that section, a small copy of the triggering emoji appears in the gutter at the fold point. Expand the section and the marker disappears.

## ⚠️ Follow up with Alex          ← collapsed → shows ⚠️ in gutter
## Meeting notes                    ← collapsed, no watched emoji → no marker
## 🔴 Blocked: waiting on design   ← collapsed → shows 🔴 in gutter

The marker reflects whichever watched emoji appears first inside the folded content — it doesn't have to be in the heading itself.

Default emoji set

⭐ 🔴 🟠 🟡 🟢 🔵 🟣 🟤 ⚫ ⚪ ⚠️ ❗ ❓ 🚩 📌 💡 🔥 🎯 ✅ 💬 📝

Requirements

  • Obsidian v1.4.0 or later
  • Live Preview mode enabled
  • Desktop only (no mobile support yet)

Installation

This plugin is not yet in the Obsidian community plugin registry. To install manually:

  1. Download main.js, manifest.json, and styles.css from the latest release
  2. Copy them into <your vault>/.obsidian/plugins/margin-markers/
  3. Reload Obsidian and enable the plugin in Settings → Community Plugins

Building from source

git clone https://github.com/cyber-rye/obsidian-margin-markers
cd obsidian-margin-markers
npm install
npm run build

Then copy main.js, manifest.json, and styles.css into your vault's plugin folder.

Roadmap

  • Configurable emoji set via settings
  • Reading mode support
  • Mobile support

Support

If this is useful to you: PayPal

License

MIT

About

Gutter markers for collapsed headings and blocks containing attention emojis.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors