Ray Notes

approvedunreviewed

by CJ Kim

Open and edit notes in compact, always-on-top windows inspired by Raycast Notes.

★ 1 stars↓ 968 downloadsUpdated 12d agoMIT

Ray Notes

English | 한국어

GitHub release Support on Ko-fi

Ray Notes opens notes from a dedicated Obsidian folder in compact, always-on-top windows inspired by Raycast Notes. It uses Obsidian's native Markdown editor, so your notes remain ordinary Markdown files in your vault.

Ray Notes is an independent project and is not affiliated with Raycast.

Preview

Edit Markdown in a compact window with file properties, tasks, quotes, and tables.

Ray Notes showing file properties, tasks, a quote, and a table

Browse NotesAction Panel
Browse Notes filtered to example notesAction Panel showing searchable commands and keyboard shortcuts
Find in NoteFormatting controls
Find bar above a Markdown noteFormatting toolbar with the heading menu open

Minimal Mode keeps just the note title and a short preview visible.

Ray Notes in Minimal Mode

Screenshots use example notes on macOS with Raycast appearance and Translucent window enabled. Select an image to view it at full size.

Features

  • Compact popout windows without Obsidian's ribbon, tab bar, view header, or status bar
  • Native editing and reading modes with Raycast-inspired typography and Markdown styling
  • Always on Top, Minimal Mode, multiple note windows, and optional macOS Show on All Spaces
  • Configurable global shortcut for showing or hiding the primary window from any app
  • Browse Notes searches both titles and note contents, with pinned and recently opened notes
  • Floating formatting controls, action panel, in-note search, and file properties support
  • Optional translucent window and screen-sharing privacy controls
  • Automatic title and filename generation from the first meaningful line
  • Restored note, window position, size, and recent-note state between sessions
  • obsidian://ray-notes protocol support for external launchers

Requirements

  • Obsidian 1.7.2 or later
  • Desktop only

Installation

Community plugins

  1. Open Settings → Community plugins → Browse.
  2. Search for Ray Notes.
  3. Select Install, then Enable.

Manual installation

  1. Download main.js, manifest.json, and styles.css from the latest GitHub release.
  2. Place the files in <vault>/.obsidian/plugins/ray-notes/.
  3. Reload Obsidian and enable Ray Notes under Settings → Community plugins.

Usage

Run Ray Notes: Open notes window from the Command Palette or use the ribbon icon. By default, Ray Notes stores files in the Ray Notes folder and registers Option+N as its global shortcut.

Common macOS shortcuts:

ActionShortcut
Create NoteCommand+N
Browse NotesCommand+P
Previous / Next NoteCommand+[ / Command+]
Find in NoteCommand+F
File PropertiesCommand+;
Bold / Italic / UnderlineCommand+B / Command+I / Command+U
StrikethroughShift+Command+S
Inline CodeOption+Command+E
Heading 1–3Option+Command+1–3

Use Ctrl in place of Command for Mod shortcuts on Windows. The global shortcut can be changed or disabled in the plugin settings.

Settings

  • Notes folder
  • Default Always on Top state
  • Show on All Spaces on macOS
  • Global shortcut and shortcut recording
  • Raycast appearance and translucent window
  • Where notes from the Ray Notes folder open
  • Whether the main Obsidian window is minimized when Ray Notes opens

Support

Report bugs and request features in GitHub Issues. If Ray Notes helps your workflow, you can support its development on Ko-fi.

Limitations

Ray Notes runs inside Obsidian, so Obsidian and the vault must remain open. Quitting Obsidian also closes Ray Notes windows.

Window translucency uses Electron's macOS vibrancy. Themes or plugins that add opaque backgrounds can reduce or hide the effect.

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.