Notes in Markdown
A Markdown note-taking app, with notes as plain files.
MarkdownMate is a free notes app for Mac and Ubuntu that works on a folder of Markdown files you own. Link notes, tag them, keep a daily note and search them all, without an account. Everything below is in both apps.
Your notes are files
MarkdownMate opens a folder of .md files, the one you already have or a new one, and every note stays a plain Markdown file in it. No database, no import, no export step: any other editor can open the same notes. To share a note outside Markdown, export it as PDF, HTML or RTF.
There is no account and no sync of its own, so you choose how notes travel. Mac: keep the folder in iCloud Drive, or use Git or Dropbox. Ubuntu: use Syncthing, Nextcloud, Dropbox or Git. Backups are plain file copies. Coming from an Obsidian vault? See what works when you open one.
Start with a notes folder
Not sure where to keep notes? Create Notes Folder… makes the folder for you and adds a welcome note and a short tour that link to each other, plus the four starter templates in its Templates folder. It takes a new or empty folder; a folder of notes you already have opens like any other, exactly as it is.
Mac: the Create Notes Folder… button in the empty sidebar, or File ▸ New Notes Folder… at any time. Ubuntu: the same button while no folder is open, or main menu ▸ New Notes Folder… at any time. The notes it makes are the same in both apps, and they stay plain .md: delete the welcome notes once you know your way around.
Wiki links and backlinks
Met with the team about [[Project Plan]].
See [[Project Plan#Budget|the budget]].
Type [[ and a note's name to link to it; a link can point to a heading and show its own text. Follow it in the editor or the preview, and use Back and Forward to return. When you rename or move a note, links to it can be updated.
Point at a link to see the linked note's first lines without leaving yours, and drop a note from the sidebar into the editor to insert a [[wiki link]] to it. A note's other names under aliases: in its front matter work as link names too.
Under the Outline, Backlinks lists every note that links to the current one, by wiki link or relative Markdown link. Both apps have it. The full guide is on wiki links and backlinks.
Unlinked mentions
Unlinked Mentions lists the notes that name the current note without linking to it, as a whole word in any case. Open one at the mention, or click Link to turn it into a [[wiki link]]. Both apps have it.
Tags and Rename Tag
#reading #work/project
Write #tag or a nested #work/project anywhere in a note. The sidebar's Tags section lists them as a tree; pick one to see its notes. Typing # suggests the tags you already use.
Tags in a note's YAML front matter count too: tags: [a, b], a list of - a lines, or tags: a, b. They show in the Tags section and # completion, and Rename Tag changes them as well.
The full guide is on tags in Markdown notes. Right-click a tag ▸ Rename Tag… to rename it in every note of the folder, nested tags included. You see how many notes change first, and Undo works in the open note.
Daily notes and templates
# {{title}}
Created {{date}}
Today's Note (⌘D on Mac, Ctrl+D on Ubuntu) opens today's note, Daily/YYYY-MM-DD.md, and creates it the first time each day, from a Template.md in that folder when there is one. Previous / Next Daily Note (⌥⌘[ / ⌥⌘] on Mac, Ctrl+Alt+[ / Ctrl+Alt+] on Ubuntu) steps between the days you wrote, and Daily Note for Date… opens or creates the note of any day you pick on a calendar. The daily note name setting changes how the notes are named, such as YYYY/MM/YYYY-MM-DD for a folder per month. See daily notes and journaling in Markdown.
New from Template starts a note from any file in your Templates folder, with {{date}}, {{time}}, {{title}} and formatted dates like {{date:dddd, MMMM D, YYYY}} filled in, and the cursor where {{cursor}} was. With no templates yet, Create Starter Templates… adds four. Get ready-made note templates to download, or see templates in the Markdown guide.
Find and Replace in Folder
Find in Folder (⇧⌘F on Mac, Shift+Ctrl+F on Ubuntu) searches every note in the folder, fast even with thousands of files, with Match Case and Whole Word. Replace All changes every listed match after showing how many notes it touches. Right-click a folder in the sidebar ▸ Find in “Name”… to search and replace only inside it.
Three lists show what needs attention across the folder, by note and line: Find Broken Links… (wiki links to no note or alias, relative links and images whose file is missing), Find Open Tasks… (every unchecked - [ ]) and Find Unused Attachments… (files in assets folders no note uses; MarkdownMate never deletes them). On Mac they are under Edit ▸ Find, on Ubuntu in the main menu; each is also a toggle in Find in Folder.
To split a long note, select text and choose New Note from Selection… (⌥⇧⌘N on Mac, Shift+Ctrl+Alt+N on Ubuntu): the text moves into a new note and a [[wiki link]] to it takes its place. Undo puts it back.
Outline and table of contents
[TOC]
The Outline panel lists the headings of the current note; click one to jump there. A line with only [TOC] shows the note's headings as links in the preview and in exports. More syntax is in the Markdown guide, and every key in the keyboard shortcuts.
Get MarkdownMate
Ubuntu
sudo add-apt-repository ppa:homielab/markdownmate
sudo apt update
sudo apt install markdownmate
Ubuntu 24.04 or later (amd64)
No account, no cloud: notes stay as .md files on your disk.