Markdown notes, versioned automatically.
A native macOS app for plain Markdown files, with git history, prompt templates and voice notes.
Website · Features · Building · MIT License
I wanted a simpler note-taking app: plain Markdown files, several separate vaults, and every change versioned with git without having to think about it.
I also kept rewriting the same AI prompts, so I added templates: put parameters in a note, fill in a form, copy the result. Voice notes and video reviews came next, because some thoughts are faster to say or show than to type.
- Notes are files. Any folder can be a vault. Open several at once, each in its own window, and switch between
recent ones. No database and no proprietary format: just Markdown files in the vault's
files/folder, in a git repository. Existing NoteMD vaults move intofiles/with one commit the first time they open; other git repositories keep their layout. - Incognito notes. Jot something down without a trace (⌃⌘N): incognito notes get their own sidebar section, are never committed and are deleted when you close the window or quit. Move one into a folder to keep it.
- Hidden folders and secret notes. Hide a folder to keep it, its notes and their tags out of sight until you unlock
NoteMD with Touch ID, an Apple Watch or your password (hiding isn't encryption: the files stay readable in Finder).
Make a note secret to encrypt it on disk in the open age format: it's listed by file
name only while NoteMD is unlocked and decrypted when you open it, so copies, backups and git remotes never hold its
text. A recovery key, shown once at setup, opens secret notes on another Mac or with
age -d. NoteMD locks again after up to five idle minutes, with Lock Now (⌃⌘L), screen lock, sleep or quit. - Versioned automatically. Edits are saved as you type and committed a few seconds after you stop (configurable), when you close the window, on quit and with ⌘S. Version History shows what changed in each version, compares any of them with the current text and restores one as a new commit. Deleted notes can be restored too.
- Templates for reusable prompts. Add
paramsto a note's front matter and use{{name}}placeholders, plus{{#if}},{{#elseif}},{{#unless}}and{{#each}}blocks. Conditions can compare values ({{#if language == Swift}},{{#if max >= 10}}), and the parameters editor has a syntax guide one click away. Convert any note to a template and back, in place or as a copy. Use Template opens a form (text, long text, number, toggle, choice, multiple choice, file, folder, date and list fields) and gives you the result to copy or save as a note. To have an AI agent write templates for you, point it at the create-reusable-prompt skill and its front matter JSON Schema. - Voice notes. Record into a note and transcribe the clip with on-device speech recognition. The transcript is added below the clip as a quote; the audio never leaves your Mac.
- Attachments and video reviews. Drag or paste images, recordings and other files into a note. They are copied into
the vault's
files/assets/folder (or linked where they are), stored with Git LFS, and audio and video play inline in the preview. A paperclip in the note list shows which notes have attachments and warns about broken links. The Assets view lists every file with where it's used, finds unused and missing ones, and renames or bins them while keeping the notes' links right. - Organize and find. Folders with a color and an icon, tags in front matter (
tags:), and search across titles, tags and text withtag:name/#namefilters. - GitHub Flavored Markdown. Tables, task lists, footnotes, alerts and autolinks, rendered by cmark-gfm, with Editor, Split and Preview modes (⌘1, ⌘2, ⌘3). Click a task's checkbox in the preview to tick it off in the note. Find and replace in any note (⌘F, ⌥⌘F), and line numbers and invisible characters (spaces, tabs, line breaks) are one click away in the View menu.
- Bring Markdown files in. Open a
.mdfile from Finder, drop it on the Dock icon or send it from the Share menu, and NoteMD copies or moves it into the vault you pick. A file that's already in one of your vaults opens there. NoteMD appears under Open With for Markdown files only, without becoming the default app. - Notes from anywhere. Create notes from other apps through the Share menu, the Services menu, the Dock icon, drag and drop or paste: text and links become the note, images, recordings and PDFs are attached to it.
| Templates with parameters | Version History |
| Voice notes and transcription | Video reviews |
- macOS 26 or later on Apple silicon
git(Xcode Command Line Tools or Homebrew)git-lfsfor attachments (brew install git-lfs)- Xcode 26 or later to build
Get the DMG from the latest release: signed with Developer ID and
notarized by Apple, and it updates itself. Each release lists SHA-256 checksums; check a download with
shasum -a 256 -c SHA256SUMS --ignore-missing.
git clone https://github.com/itsjavi/notemd.git
cd notemd
make install # builds build/NoteMD.app and copies it to /ApplicationsOther targets: make app (release build only), make run (debug build), make test (unit tests),
make build-notarized (signed and notarized app, zip and DMG in build/release; needs a Developer ID Application
identity and a notarytool Keychain profile) and make install-notarized (installs that build). The Share menu lists
NoteMD once the release build is in /Applications. Releases are published from version tags with make bump; see
docs/releasing.md.
See AGENTS.md for the project layout, build variants and test hooks. The website lives in web/ and
is deployed to GitHub Pages on every push to main that touches it.