All Features

Three steps from typing your first note to power-user.

1

Basics

The minimum to write your first note in Kavya. If you only learn this, you already have a solid local Markdown editor.

Your vault & library

Vault = folderEvery group is a directory on disk. Every sheet is a plain .md file. No database, no lock-in.
Three-panel layoutLibrary on the left, sheets in the middle, editor on the right. Zero learning curve.
Nested groupsUnlimited folder hierarchy mapped to real directories on disk.
Projects & NotesTwo top-level sections to separate structured work from loose notes. Convert between them via right-click.
Drag-and-dropReorder groups with a blue line indicator. Nest them with a green highlight.
Resizable panelsResize or hide any panel. Collapse the library, expand the editor, or go full zen.
Custom group iconsPick icons and colors for any group. Visual cues make large vaults navigable.
YAML frontmatterMetadata lives in the file itself: title, tags, dates, goals. Compatible with Obsidian and Hugo.

Writing

CodeMirror 6 editorFast, accessible Markdown editor with full syntax highlighting. Handles large documents without lag.
Bundled fontsSix variable fonts included: Inter, iA Writer Duo, Literata, Source Serif 4, JetBrains Mono, Roboto Mono. All OFL-licensed.
Find & replaceCmd+F for the current sheet. Regex support. Highlight all matches.
Dark & light themesSwitch between dark and light with one click.
2

Daily use

When Kavya becomes your day-to-day system: capturing thoughts, finding what you wrote last week, planning what to do next, and exporting.

Capture & navigate

Quick CaptureCmd+N opens a Drafts-style overlay to dump a thought into Inbox without leaving the current sheet. Also bindable as a system-wide hotkey in Settings — capture from any app, Kavya hides itself after you save.
Daily notesCmd+D creates or opens today’s journal entry in a Journal/YYYY/MM Month/ hierarchy.
Quick SwitcherCmd+O to fuzzy-search and jump to any sheet instantly.
Command paletteCmd+P to find and run any command.
Navigation historyCmd+[ / Cmd+] to revisit sheets. Like a browser, but for notes.

Find & organize

Full-text searchCmd+Shift+F across all sheets. Debounced input with centered match snippets.
Search operatorstag:, group:, before:, after:, is:favorite narrow results.
Tags & keywordsTag sheets with colored keywords. Filter by tag across the entire vault. Stored in YAML frontmatter.
Smart filtersBuilt-in filters: All, Last 7 Days, Trash.
Pinned favoritesTop-5 starred sheets pinned inline in the library, ordered by when starred. Click the star to unfavorite.
WikilinksType [[ to link between sheets. Fuzzy-search dropdown; recently visited sheets appear first.
BacklinksSee every sheet that links to the current one. Fast even with thousands of sheets.

Editor superpowers

No toolbarsEvery command lives in the macOS menu bar and the command palette. Selecting text pops up a small floating bar with the formatting you reach for most.
The / menuType / at the start of a line for task and bullet lists, headings, quotes, tables, dividers, code and math blocks.
Task listsCmd+Shift+T, or type [] and a space. Click to tick. Every sheet with an open task appears under Open Tasks in the sidebar.
Live previewMarkdown markup hides itself as you write. The element under your cursor still shows it, so you always see what you are typing.
MathFormulas between $…$ and $$…$$, rendered by KaTeX inside the app. No network.
Custom themesDrop a .css file into _kavya/themes and pick it from the command palette. Themes travel with the vault.
Typography panelView → Typography… Change font family, size, line height, and letter spacing. Preferences persist across sessions.
Smart typographyAuto-converts straight quotes to curly quotes (“”) or guillemets (« »), -- to em dash, ... to ellipsis.
Focus modeDims everything except the current paragraph. Paragraph-aware, matching how prose writers think.
Typewriter modeKeeps the active line centered on screen.
Zen modeHides all panels for distraction-free writing.
Outline panelShows all headings. Click to jump. Drag to reorder sections.
Multi-cursorCmd-click to add cursors anywhere.
List continuationEnter continues - , * , 1. (auto-increment), and > . Empty prefix exits.
Smart pastePaste HTML from the web and get clean Markdown.
Writing goalsSet word count targets per sheet. Animated progress ring tracks how close you are.
Live statisticsWords, characters, sentences, paragraphs, and estimated reading time.
TemplatesCreate sheets from reusable templates stored in your vault.

Files & export

Export to MarkdownCopy or save as .md. Strips frontmatter, keeps the content.
Export to HTMLRendered Markdown to clipboard or file. Proper headings, lists, code blocks, links.
Export to PDFFormatted export with proper typography. XSS-sanitized for safety.
Export to DOCXWord document export for editors, publishers, or anyone who needs .docx.
Real-time syncFilesystem watcher plus polling detects external changes instantly.
Trash & restoreDeleted sheets move to a trash folder. Nothing is lost until you empty the trash.
Reveal in FinderRight-click any group, sheet, or reference file to show it in Finder.
3

Advanced

Deep features for power users: AI reflections (BYOK), research workflows, sharing, and the long tail of tools that quietly make Kavya yours.

AI, with your own key (BYOK)

Edit the selectionAlt+Cmd+A rewrites, shortens, lengthens, fixes grammar or simplifies. Five closed instructions, no free-text box.
Arrives marked, not appliedThe change comes in highlighted. Enter keeps it, Esc restores your text character for character.
Authorship in the fileWhat you keep is recorded in the note itself, in the open Markdown Annotations format iA published, with a SHA-256 that notices when the note was edited elsewhere.
Three providersClaude (Sonnet 5, Opus 5, Haiku 4.5), OpenAI (GPT-5.6 Terra, Sol, Luna), and Google Gemini (3.7 Flash, 2.5 Pro). Your key, your account.
No server in the middleKeys are stored on your Mac. Text goes from your Mac to the provider you configured. Kavya has no server.
Off by defaultNothing is sent anywhere until you enter a key. The rest of Kavya works with no network at all.

Split & merge

Split viewEdit two sheets side by side, or view a Markdown preview next to your source.
Split sheetCmd+Shift+D splits a sheet into two at the cursor position.
Merge sheetsSelect multiple sheets, right-click to combine. Originals go to trash (restorable).
Sentence navigationCtrl+. / Ctrl+, jump between sentences. Abbreviation-aware.
Attachments & notesAttach files and annotations to any sheet. Images display inline.

Research & reference files

PDF viewerRead PDFs without leaving the app. Drop them into any group.
EPUB readerBuilt-in EPUB reader with page navigation. Read books alongside your notes.
Image viewerView images inline. Drop screenshots, diagrams, or photos into any group.
Separate from notesReference files never appear in the sheet list. Your writing space stays clean.
File managementRight-click for Delete, Move to, Open Externally, or Reveal in Finder.
Smart drag-and-dropFiles import into the selected group. Duplicate detection alerts before creating copies.

Share your plan

Send to iCloudHTML file with clickable checkboxes in iCloud Drive/Kavya/.
Copy as textPlain-text checklist to clipboard. Paste anywhere.
Copy as cardRich HTML card to clipboard. Paste in Apple Notes for a formatted overview.
Copy as imagePNG card to clipboard. Share a snapshot of your plan.
Save as imageSave the column as a PNG file. Choose where to put it.
Spanish interfaceSettings → Appearance → Language. Switches the UI to Spanish (Español).
Group header dragDrag group headers to move entire groups between columns at once.

Power tools

Deep linksEvery sheet has a kavya://sheet/<id> URL. Press Cmd+L to copy it.
Incremental scanVault rescan uses file mtime cache. Only re-parses changed files.
Duplicate detectionFiles duplicated on disk get unique IDs automatically. No collisions.
Ulysses importImport your entire Ulysses library without losing structure.
Reset UI preferencesSettings → Advanced → Reset clears panel widths, last–opened view, locale, and other interface state with one click. Your notes, vault path, and AI keys are kept.
⌨

Keyboard shortcuts

Every action from the keyboard. No mouse required.

ShortcutAction
Cmd+NQuick Capture into the Inbox
Cmd+Shift+NNew sheet in the current folder
Cmd+Shift+SpaceQuick Capture from any app
Cmd+DDaily note
Cmd+PCommand palette
Cmd+OQuick Switcher
Cmd+FFind in current sheet
Alt+Cmd+FFind & replace in current sheet
Cmd+Shift+FSearch all sheets
Cmd+Shift+HFind & replace across the vault
Cmd+SSave now (Kavya also saves as you type)
Cmd+LCopy deep link
Cmd+EExport
Cmd+Shift+DSplit sheet at cursor
Alt+Cmd+GGlue selected sheets
Cmd+BBold
Cmd+IItalic
Alt+Cmd+UStrikethrough
Cmd+JInline code
Cmd+Shift+JCode block
Cmd+KLink
Cmd+Shift+KWikilink
Cmd+Shift+TTask list
/Block menu (at the start of a line)
Alt+Cmd+AEdit the selection with AI
Cmd-clickAdd a cursor
Cmd+1Editor only
Cmd+2Sheets + Editor
Cmd+3All panes
Cmd+Shift+PPreview
Cmd+[ / Cmd+]Navigate back / forward
Cmd+/All keyboard shortcuts