Features & Workflows

Note editor

The editor is built on CodeMirror 6 with full markdown syntax highlighting and optional vim keybindings. Three view modes are available:

• Editor — full-screen markdown editing with syntax highlighting
• Preview — rendered markdown output with proper formatting
• Split — side-by-side editor and preview for real-time feedback

Autosave is enabled by default — your changes are persisted automatically after a short debounce. You can also save manually with Cmd+S.

Full-text and semantic search

m-notes supports three search modes, accessible from the search bar or command palette (Cmd+K):

• Full-text — keyword matching using PostgreSQL full-text search. Fast and precise for exact terms
• Semantic — meaning-based search using AI embeddings. Finds related content even when exact words differ
• Hybrid — combines both modes with relevance scoring for the best overall results. This is the default

Wikilinks and backlinks

Link notes together with [[Note Title]] syntax. Wikilinks are resolved by title (case-insensitive) and rendered as clickable links in preview mode.

• Clicking a wikilink navigates to the linked note, or creates it if it does not exist
• The backlinks panel (below the editor) shows all notes that link to the current note
• Use get_note_links via MCP to programmatically traverse links

Graph view

The graph view visualizes your notes as an interactive network. Nodes represent notes and edges represent wikilink connections between them.

• Access the graph from the sidebar or via the graph icon in the toolbar
• Click a node to navigate to that note. Hover to see the title and connection count
• Zoom and pan to explore clusters of related notes

Tags system

Tags live in YAML frontmatter and provide cross-folder categorization:

• Add tags in the frontmatter tags array or via the tag editor in the note panel
• Tags are synced between frontmatter and the database automatically
• Filter notes by tag in the sidebar, or search with tag filters in the search bar
• Via MCP, use manage_tags to add/remove and search_by_tags to query

Version history

m-notes automatically creates snapshots of your notes so you can review and restore previous versions.

• Open the version history panel from the note toolbar to see all saved snapshots
• Preview any snapshot to see the content at that point in time
• Restore a snapshot to revert the note to a previous state

Starred and pinned notes

Keep important notes within easy reach:

• Star a note to add it to your starred section in the sidebar for quick access
• Pin a note to keep it at the top of the note list in its folder
• Toggle both from the note context menu (right-click) or the note toolbar

Command palette

Press Cmd+K (Ctrl+K on Windows/Linux) to open the command palette. From there you can:

• Search for notes by title
• Run quick actions (create note, toggle theme, open settings)
• Navigate to any page in the app

See Keyboard Shortcuts for the full list of available shortcuts.

Image upload

Add images to your notes with drag-and-drop or paste:

• Drag an image file into the editor or paste from clipboard
• Images are uploaded automatically and a markdown image link is inserted
• Supported formats include PNG, JPEG, GIF, and WebP

Workspaces

Workspaces let you isolate different projects or contexts. Each workspace has its own set of notes, folders, and tags. Switch between workspaces from the sidebar or settings.

Learn more in the Workspaces guide.