EdgeMark

A native macOS side-panel Markdown notes app. Always one edge away.

Why EdgeMark exists: SideNotes nailed the interaction — a notes panel that slides in from the screen edge, always one gesture away. But it's closed-source and paid, with no way to contribute, customize, or verify what it does with your data.

EdgeMark is the open-source alternative: lightweight, Markdown-first, and yours to inspect, modify, and extend. Your notes are plain .md files on disk — open them in any editor, sync with any service, back them up however you want.

Install

brew install --cask ender-wang/tap/edgemark

Or download the latest .dmg from Releases, install it, and then run this command in Terminal:

xattr -cr /Applications/EdgeMark.app

---

Features

🪟 Side Panel

• 🔲 Borderless floating panel, full-height, always on top
• 🖥️ Works on every virtual Desktop and alongside fullscreen apps
• ✨ Smooth slide-in/out or fade animation (configurable) with edge activation — move mouse to screen edge to reveal
• 🖱️ Click outside, Escape, or auto-hide dismissal
• 📌 Pin to keep the panel open — survives focus changes, mouse exit, and Space switches (great for copy-pasting back and forth)
• 📐 Multi-monitor support with configurable left or right edge
• ↔️ Adjustable width — drag the inner edge to resize, saved across restarts
• 🎨 Panel tint — pick from a curated palette (System, Graphite, Slate, Sand, Sage, Rose)

✍️ Markdown Editing

• 👁️ CodeMirror 6 WYSIWYG editor with cursor-aware live preview (hides syntax, reveals on cursor line)
• 📝 Full Markdown: headings, bold, italic, code, lists, task lists, blockquotes, links, tables (rendered as formatted grids)
• 🖼️ Inline images — paste (⌘V) or drag to embed; stored as co-located asset files alongside the note
• ✅ Checked task items are automatically struck through; uncheck to restore
• 📋 One-click Copy button on fenced code blocks
• 🔴 Spell checking with dotted underlines (macOS system dictionary, respects custom word lists)
• ⚡ Slash commands (/h1, /todo, /code, /quote, /table, /divider, and more)
• ⌨️ Formatting shortcuts: ⌘B bold, ⌘I italic, ⌘E inline code, ⌘K link, ⇧⌘X strikethrough
• 🔗 ⌘Click a rendered link to open it in the browser
• 🔍 Find & Replace (Cmd+F)
• 🔤 Customizable editor font and size — pick any installed font via the system font panel with live preview

🗂️ Notes & Storage

• 📄 Plain .md files with YAML front matter — open in any editor, sync with any service
• 📁 Folder-based organization with drag-and-drop
• 📂 Configurable storage directory
• 💾 1-second debounced auto-save
• 🔍 Search shows all notes sorted by most recently modified when the query is empty — a quick "recent notes" feed
• 🏷️ Finder-style color tags (Red, Orange, Yellow, Green, Blue, Purple, Gray) with rename-able labels; multi-tag per note
• 🎯 Tag filter inside search — click tag dots to narrow results, multi-select acts as OR, combines with text search
• 🔄 External file sync — edits from other apps are detected on panel open; prompts when both sides changed
• 🗑️ Trash with 30-day auto-purge and read-only preview

⌨️ Keyboard & Shortcuts

• 🌐 Global shortcut: Ctrl+Shift+Space toggles from any app (customizable)
• 🎹 Custom shortcut recorder with conflict detection
• ⏱️ Configurable activation delay and corner exclusion zones
• 🔑 Panel shortcuts: ⌘N new note, ⇧⌘N new folder, ⌘F search, ⌘P pin/unpin (when panel is focused)
• 👆 Two-finger trackpad swipe right on the header to navigate back (configurable toggle and sensitivity)
• 👆 Two-finger swipe left/right on the editor or ⌘←/⌘→ to navigate between notes in the current folder

🔄 Auto-Update & CI/CD

• 🔔 In-app update check (GitHub Releases, 24h throttle)
• 📦 Download with progress bar, SHA256 verification, install & restart
• ⚙️ GitHub Actions build pipeline (unsigned Release, DMG, SHA256)
• 🍺 Homebrew Cask installation

🌟 Quality of Life

• 🌗 Appearance override: System, Light, or Dark mode
• 📌 Menu bar resident (no Dock icon)
• 🚀 Launch at login
• 📋 Copy as Plain Text, Markdown, or Rich Text — selection-aware in editor with right-click context menu
• 🎨 SF Symbol icons throughout all context menus
• 🔀 Smooth directional page transitions
• 🌍 English + Simplified Chinese (JSON-based, easy to contribute)

---

Contributing

See CONTRIBUTING.md for architecture overview, source tree, key patterns, localization guide, and development setup.

---

License

EdgeMark is licensed under the GNU General Public License v3.0.

Acknowledgments

EdgeMark is built on top of these open-source projects:

Project	License	Description
CodeMirror 6	MIT	Extensible code editor — powers the WYSIWYG Markdown editing experience
Lezer	MIT	Incremental parser system used for live Markdown syntax highlighting
SwiftFormat	MIT	Code formatting tool used in the build pipeline

---

Star History