Skip to content
itsjaviPublic

About

Markdown notes with git-versioned vaults, reusable note template editor, voice notes with on-device transcription, and more!

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

NoteMD app icon

NoteMD

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

The NoteMD window: colored folders and tags in the sidebar, the note list, and a note shown as Markdown source next to its rendered preview.

▶ Watch the 42-second intro

Why NoteMD

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.

Features

  • 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 into files/ 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 params to 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 with tag:name / #name filters.
  • 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 .md file 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.
Template form for a code review prompt, with the rendered prompt next to it. Version History with a diff of the lines added in the selected version.
Templates with parameters Version History
A note with a voice note player and its transcript. A review note with an embedded video and time-stamped feedback.
Voice notes and transcription Video reviews

Requirements

  • macOS 26 or later on Apple silicon
  • git (Xcode Command Line Tools or Homebrew)
  • git-lfs for attachments (brew install git-lfs)
  • Xcode 26 or later to build

Download

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.

Building

git clone https://github.com/itsjavi/notemd.git
cd notemd
make install  # builds build/NoteMD.app and copies it to /Applications

Other 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.

License

MIT

About

Markdown notes with git-versioned vaults, reusable note template editor, voice notes with on-device transcription, and more!

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages