Skip to content

starc007/markd

Repository files navigation

Markd

Local-first notes for people who write.

Markd is a macOS-first notes app built for developers and content creators who care about speed, privacy, and ownership.

No accounts. No cloud. No sync (for now).

Your notes live on your Mac as plain .md files. Markd simply makes writing and finding them fast.


Installing on macOS

Download the latest .dmg from usemarkd.app and drag Markd to Applications.

Markd is signed but not yet notarized, so on the first launch macOS asks to verify it. Open it once, either way:

Terminal

xattr -dr com.apple.quarantine /Applications/Markd.app

Then open Markd normally.

Or via Settings

Double-click Markd → click DoneSystem Settings → Privacy & SecurityOpen Anyway → authenticate. macOS remembers the choice after that.

Notarization (which removes this prompt entirely) needs an active Apple Developer account and is planned for a future release.


Features

  • WYSIWYG markdown editor — write in a rich editor, saved as clean markdown on disk
  • Folders & subfolders — organize notes in real, Finder-visible folders
  • Todos — a standalone task list with tags and filtering
  • Bookmarks — save links with auto-fetched title, image, and favicon; tag and filter them too
  • ⌘K command palette — jump to any note, folder, or page instantly
  • Instant search — title + content, ranked, in milliseconds
  • Monochrome UI — light, dark, or system theme; no color noise
  • Portable vault — plain files, no IDs, no frontmatter, no lock-in

Vault model

Pick any folder on disk as your vault:

<vault>/
├── notes/          plain .md files — filename is the title, folders are real folders
└── .markd/         app data: todos, bookmarks, tags, pasted images

Notes are addressed by path, never by ID. Deletes go to the OS trash. Edit notes externally (vim, VS Code, whatever) — Markd picks up changes on window focus.


Getting started

Requirements: Bun, Rust, and Xcode Command Line Tools.

bun install
bun tauri dev      # run the app

Build a release bundle:

bun tauri build    # produces a .app and .dmg under src-tauri/target/release/bundle

See AGENTS.md for architecture details, or CONTRIBUTING.md to send a PR.


Data & Privacy

  • Notes are stored locally as user-owned files
  • No analytics, tracking, accounts, or note-content uploads
  • Markd connects to usemarkd.app to check for application updates
  • Saving a bookmark fetches that page's title, preview image, and favicon
  • Export your notes anytime — they're already just files

Status

Markd is under active development. Sync, encryption, and publishing may be added later — without compromising local-first performance.

License

MIT


Markd Write at the speed of thought.

About

Local-first notes for people who write.

Topics

Resources

License

Contributing

Stars

22 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors