README file from
GithubRay Notes
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.
| Browse Notes | Action Panel |
|---|---|
| Find in Note | Formatting controls |
|---|---|
Minimal Mode keeps just the note title and a short preview visible.
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-notesprotocol support for external launchers
Requirements
- Obsidian 1.7.2 or later
- Desktop only
Installation
Community plugins
- Open Settings → Community plugins → Browse.
- Search for Ray Notes.
- Select Install, then Enable.
Manual installation
- Download
main.js,manifest.json, andstyles.cssfrom the latest GitHub release. - Place the files in
<vault>/.obsidian/plugins/ray-notes/. - 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:
| Action | Shortcut |
|---|---|
| Create Note | Command+N |
| Browse Notes | Command+P |
| Previous / Next Note | Command+[ / Command+] |
| Find in Note | Command+F |
| File Properties | Command+; |
| Bold / Italic / Underline | Command+B / Command+I / Command+U |
| Strikethrough | Shift+Command+S |
| Inline Code | Option+Command+E |
| Heading 1–3 | Option+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.