Skip to content
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

371 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Markd

Local-first notes for people who write.

Note

This is Celados' Octane-based fork of starc007/markd. The framework port is complete and keeps the product behavior and Tauri data model intact. Upstream currently owns the public website, cloud service, signed binaries, and update channel; this repository is the source for Celados' independent fixes and customization.

Markd is a fast notes app for macOS and Linux, built for people who care about speed, privacy, and ownership.

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

Your notes live on your disk 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 releases are Developer ID signed and notarized by Apple before distribution.


Installing on Linux

Download the latest AppImage or Debian package from the GitHub releases page.

Run the AppImage:

chmod +x Markd_*_amd64.AppImage
./Markd_*_amd64.AppImage

Or install the Debian package:

sudo apt install ./Markd_*_amd64.deb

Features

  • WYSIWYG markdown editor: write in a rich editor, saved as clean markdown on disk
  • Folders and subfolders: organize notes in real, file-manager-visible folders
  • Todos: a standalone task list with tags and filtering
  • Bookmarks: save links with an auto-fetched title, image, and favicon
  • Command palette: press Ctrl/Cmd+K to jump to any note, folder, or page instantly
  • Instant search: title and content, ranked in milliseconds
  • Monochrome UI: light, dark, or system theme with no color noise
  • Portable vault: plain files, no IDs, no required metadata, no lock-in

Vault model

Pick any folder on disk as your vault:

<vault>/
├── Note.md         plain .md files, filename is the title
├── projects/       real folders containing more notes
└── .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 with vim, VS Code, or another editor. Markd picks up changes on window focus.


Getting started

Requirements: pnpm, Rust, and the platform dependencies listed in the Tauri prerequisites.

pnpm install
pnpm tauri dev      # run the app

Build a release bundle:

pnpm tauri build

Maintainers can follow NOTARIZATION.md to configure Developer ID signing and Apple notarization for releases.

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 on macOS or GitHub Releases on Linux to check for application updates
  • Saving a bookmark fetches that page's title, preview image, and favicon
  • Export your notes anytime because they are already just files

Status

This fork is under active development. Its React-to-Octane migration has passed the app's type, logic, production-build, browser-journey, Rust, and native-host gates.

Sync, encryption, and publishing may be added later without compromising local-first performance.

License

MIT


Markd Write at the speed of thought.

About

Celados' Octane-based fork of Markd, a local-first Markdown notes app.

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages