Markdown editor for Ubuntu

A native Markdown editor for Ubuntu.

A fast Markdown notes app for GTK 4 and libadwaita, with a live preview. Open the folder of .md files you already have and start writing.

Install from the PPA

Free · Version 0.13.0 · Ubuntu 24.04 or later

No account · Works offline · Plain .md files

MarkdownMate on Ubuntu with a note and its live preview side by side

Follows your GNOME style

No account, works offline

Your files stay yours

Keep ownership simple

Plain text is a great place to think.

MarkdownMate opens and saves standard .md files right where you keep them. Organize them in Files, version them with Git, or sync them with Syncthing, Nextcloud or Dropbox — no database to import or export. Written in Rust, it starts fast and stays light.

What you get in 0.13.0

Everything essential.
Nothing in the way.

Shortcuts use Ctrl. MarkdownMate for Ubuntu is in early development, and new features arrive with each release. See note-taking with plain Markdown files.

Write, preview, or both

  • Edit, Preview and Side by side (Ctrl+1/2/3), with scroll sync both ways
  • Markdown highlighting and inline styling as you type
  • Find & Replace (Ctrl+F, Ctrl+H) and Go to Line (Ctrl+L)
  • Spell check as you type, with corrections on right-click
  • Word and character count in the status bar
  • Orca names every button and list row, and Ctrl+Tab moves from the editor to the preview

Writing that flows

  • Smart lists and to-dos; Toggle Task with Ctrl+Enter
  • Tables that line up their columns, with row and column commands
  • A format bar for headings, bold, links, lists, quotes and code
  • Paste a URL over text for a link; web text pastes as Markdown
  • Images you paste or drop, saved next to your note or in an Attachments Folder; pasted images can be saved as PNG or JPEG and scaled down
  • Spreadsheet cells paste as a table; code block languages pop up as you type
  • ==Highlights== (Shift+Ctrl+H), footnotes, Move Line and Duplicate Line
  • New from Template, with {{date}}, {{time}}, {{cursor}} and {{date:FORMAT}} filled in; Create Starter Templates…
  • New Note from Selection (Shift+Ctrl+Alt+N) moves text into a linked note
  • Brackets, backticks and quotes close as you type (auto-pair)

A preview that does more

  • GitHub-flavored Markdown, code highlighting (now with TypeScript) and footnotes
  • KaTeX math formulas and Mermaid diagrams, in light and dark
  • Find in the preview, copy-code buttons, clickable to-dos
  • GitHub-style alerts, every callout kind, folded callouts and a [TOC] table of contents
  • ![[Embeds]] of images, notes and sections; image sizes like ![Photo|300](a.png); %%comments%% hidden
  • Front matter shown as a properties table, its source, or hidden
  • Line breaks: Markdown Standard, or Every New Line
  • Smart punctuation: curly quotes, dashes and … (off by default, Preferences ▸ Preview)
  • Web images only if you turn them on (Preferences ▸ Privacy)
  • Keeps up with multi-megabyte notes: only the blocks you change are redrawn

Notes that link up

  • Wiki links with completion, and links that jump to a heading or a block (^id, [[Note#^id]])
  • Rename Heading… in the Outline updates every link to that heading
  • #tags with a tag tree in the sidebar; tags and aliases in front matter
  • Hover a wiki link, in the editor or the preview, to read the note's first lines; drag a note in to link it
  • Ctrl+click a #tag to see its notes in the sidebar
  • A live outline, backlinks (fast even with 10,000 notes) and Unlinked Mentions you link in one click
  • Back (Alt+Left) and Forward (Alt+Right) through the notes you followed
  • Notes open as tabs of one window, or in separate windows (Preferences ▸ General ▸ Open files in)
  • Click a link to a note that doesn't exist yet to create it
  • Links that update when you rename or move a note; Copy Wiki Link

Find your next thought

  • Open Quickly (Ctrl+P), with your recent notes first; finds aliases, and #heading jumps to a heading in any note
  • Find in Folder (Shift+Ctrl+F) across every note, with Match Case, Whole Word and Replace All; Find in “Folder”… for one folder; tag: and path: operators
  • Find Broken Links…, Find Open Tasks… and Find Unused Attachments…
  • A folder sidebar: create, rename, drag or Move to Folder…, Trash, also several items at once (Ctrl-click, Shift-click); sort by name or date; Rename Tag…
  • Favorites: right-click a note or folder ▸ Add to Favorites pins it at the top of the sidebar, per folder, and in Open Quickly
  • Duplicate: right-click ▸ Duplicate copies a note or a whole folder as “Name copy”
  • Bookmarked and recent folders
  • Create Notes Folder… (the window's button while no folder is open, or main menu ▸ New Notes Folder…) sets up a folder with a welcome note, a short tour and templates
  • Today's Note (Ctrl+D) opens or creates today's daily note; Previous / Next Daily Note (Ctrl+Alt+[ / Ctrl+Alt+]); Daily Note for Date…; your own daily note name; open it at launch

Your look, your way out

  • Four styles in light and dark, your font and size, zoom
  • Custom CSS for the preview, Print and HTML / PDF exports
  • Line spacing and text width, line numbers, typewriter scrolling and Focus Mode (Shift+Ctrl+J)
  • Export as HTML, PDF, Word (.docx), RTF or plain text; Export Folder as HTML; Print
  • Copy as HTML or as Rich Text for LibreOffice, Thunderbird and web mail
  • Preferences ▸ Default App makes MarkdownMate the app for .md files
  • Several notes open at once, each in its own window; New Window (Shift+Ctrl+N)
  • Auto-save, and every open window comes back at the next launch
  • markdownmate:// links and a command line for scripts
  • New Note and Today's Note in the dock icon's menu and the app grid

A clear view of your work

See it on Ubuntu.

The note folder in the sidebar, tags below it, and the Markdown editor
Your folders and tags, right beside the editor.
The preview of a recipe note with an image, a tag and a table
A clean preview with images, tags and tables.
Open Quickly listing the notes that match what you type
Open Quickly: any note, a few keys away.
The notes tagged #work, listed after clicking the tag in the sidebar
Click a tag to see its notes.
The dark style with highlighted code and a table in the editor and the preview
Dark style, with highlighted code.
The Solarized Light style, showing a recipe note and its preview
Styles for the editor and the preview.
A note with a math formula and a Mermaid diagram, beside its preview
Math and diagrams in the preview.

Install

Install from the PPA.

Early development New features arrive with each release.

Published for Ubuntu 24.04 LTS (Noble Numbat), 26.04 LTS (Resolute Raccoon) and 26.10 (Stonking Stingray), on 64-bit PCs (amd64). Each Ubuntu release gets its own build while Ubuntu supports it.

sudo add-apt-repository ppa:homielab/markdownmate
sudo apt update
sudo apt install markdownmate

Free · Version 0.13.0 · Ubuntu 24.04, 26.04, 26.10 (amd64) · Launchpad PPA · Source on GitHub

Full changelog

  1. Run the three commands above in a terminal. Updates then come with your usual system updates.
  2. Open MarkdownMate from Activities, or run markdownmate ~/Notes to open a folder.
  3. Pick the folder that holds your notes. Nothing is imported: the files stay where they are.
  4. After upgrading Ubuntu, run sudo add-apt-repository ppa:homielab/markdownmate again: the upgrade turns PPAs off.

Private by default

Your notes stay on your machine.

No account, no cloud and no telemetry. The app keeps one small settings file for itself; your notes are plain Markdown in your own folders, readable by any editor, today and in decades.

Any file sync works: keep the folder in Syncthing, Nextcloud, Dropbox or Git, and changes from another device show up as you work.

Read the privacy policy.

Also on the Mac

The same notes, on both desktops.

MarkdownMate for Mac opens the same folders. Free on the Mac App Store.

MarkdownMate for Mac macOS 15.6 or later