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 & replace
Cmd+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 Capture
Cmd+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 notes
Cmd+D creates or opens today’s journal entry in a Journal/YYYY/MM Month/ hierarchy.Quick Switcher
Cmd+O to fuzzy-search and jump to any sheet instantly.Command palette
Cmd+P to find and run any command.Navigation history
Cmd+[ / Cmd+] to revisit sheets. Like a browser, but for notes.Find & organize
Full-text search
Cmd+Shift+F across all sheets. Debounced input with centered match snippets.Search operators
tag:, 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 lists
Cmd+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-cursor
Cmd-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 sheet
Cmd+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 navigation
Ctrl+. / 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.
| Shortcut | Action |
|---|---|
| Cmd+N | Quick Capture into the Inbox |
| Cmd+Shift+N | New sheet in the current folder |
| Cmd+Shift+Space | Quick Capture from any app |
| Cmd+D | Daily note |
| Cmd+P | Command palette |
| Cmd+O | Quick Switcher |
| Cmd+F | Find in current sheet |
| Alt+Cmd+F | Find & replace in current sheet |
| Cmd+Shift+F | Search all sheets |
| Cmd+Shift+H | Find & replace across the vault |
| Cmd+S | Save now (Kavya also saves as you type) |
| Cmd+L | Copy deep link |
| Cmd+E | Export |
| Cmd+Shift+D | Split sheet at cursor |
| Alt+Cmd+G | Glue selected sheets |
| Cmd+B | Bold |
| Cmd+I | Italic |
| Alt+Cmd+U | Strikethrough |
| Cmd+J | Inline code |
| Cmd+Shift+J | Code block |
| Cmd+K | Link |
| Cmd+Shift+K | Wikilink |
| Cmd+Shift+T | Task list |
| / | Block menu (at the start of a line) |
| Alt+Cmd+A | Edit the selection with AI |
| Cmd-click | Add a cursor |
| Cmd+1 | Editor only |
| Cmd+2 | Sheets + Editor |
| Cmd+3 | All panes |
| Cmd+Shift+P | Preview |
| Cmd+[ / Cmd+] | Navigate back / forward |
| Cmd+/ | All keyboard shortcuts |