Vulkan Glass is a free and open-source Markdown notes app for macOS. Each vault is a GitHub repository you own, so every note keeps its full history and syncs to every Mac you write on.
Free for macOS 14 or later. Signed and notarized by Apple.
~/Notes git log --oneline
That window is a working copy of the editor. Add a bullet, then stop typing. After 1.8 seconds the note is committed and pushed, and the git log gets a new entry. Press ⌘S to sync straight away.
Autosync is on by default. When you pause for 1.8 seconds, Vulkan Glass runs the same git commands you would. Press ⌘S to sync right away. Renaming a note is committed too, as “Rename Untitled to First Principles”.
The note is saved as a plain .md file in your vault folder. Nothing proprietary, no database.
Writing is telepathy.mdEverything that changed is staged and committed, with the note's title in the message.
git commit -m "Update Writing is telepathy"Edits from your other Macs come down first, so your new commit lands on top of them.
git pull --rebase --autostashThe commit goes up to GitHub and the status bar changes to Synced to GitHub.
git push -u origin mainIf git can’t reapply your changes cleanly, sync stops and names the files in conflict. Resolve them and the next save carries on. Vulkan Glass never picks a side for you and never force-pushes.
If you’ve used Obsidian, you can find your way around. There’s a ribbon on the left, your files beside it, the editor in the middle, and backlinks and graph on the right.
[!TIP] and [!WARNING], task lists, footnotes, and highlighted code blocks for Swift, Python, TypeScript, Rust, Go, SQL and more.[[ and pick a note from the suggestions. Link to a note that doesn’t exist yet, and following the link creates it..md file in Finder and press Space to see it rendered, without opening an app.Everything is in the menu bar with its shortcut next to it, so you can learn them as you go.
Vulkan Glass is free and MIT-licensed. It needs macOS 14 or later, and the download is signed and notarized by Apple, so it opens like any other Mac app.
Download the disk image
Drag Vulkan Glass into Applications
VulkanGlass.dmg and drag the app onto the Applications folder.Open it and choose where your notes live
You only do this once. New versions arrive through the app’s built-in updater.
Create GitHub vault
Makes a new private or public repository on your account and opens it.
Clone GitHub vault
Pick one of your repositories and use it as a vault.
Open local repository
Use a folder you already have, as long as it has a GitHub remote.
The source is on GitHub. With Xcode and mise installed, this builds a Release copy and puts it in /Applications.
$ git clone https://github.com/arkaydeustech/vulkanglass.git
$ cd vulkanglass
$ mise run setup
$ mise run install