Changelog

What's new

Version history and release notes for MacMD Viewer.

August 2, 2026
v1.6.1

Tabs that behave the way you asked them to

  • Fixed: A file double-clicked in Finder landed in a separate window even with tabs enabled. It now joins your tab group.
  • Fixed: With tabs turned off, ⌘T could still flash a window while creating a tab. New Tab and the + button are now disabled when you've opted out.
  • Fixed: With a single document open there was no tab bar, so no + button. When tabs are on, the bar is now visible from the first document.
  • Fixed: Updating from an earlier version with an activated license could be mistaken for a fresh install and switch tabs on without asking. Existing installs are now reliably recognized.
  • Fixed: A document that merely opened with a horizontal rule, followed by prose and a list, could still be swallowed into a Properties block.
  • Fixed: On slow or network volumes, the preview could freeze until the next save when a reload attempt hit the file mid-write. It now retries and catches up.
  • Improved: Quick Look previews of very large documents use less memory.

This release finishes the job v1.6.0 started. Tabs shipped; this makes them behave.

The one you will feel immediately: double-clicking a Markdown file in Finder now opens it as a tab in the window you are already using, instead of scattering a new window on the pile. That was the whole promise of tabs, and it now holds for every way a file can reach the app — Finder, the Dock, the command line, links from other apps.

The tab bar is also visible as soon as tabs are on, even with a single document, so the

  • button is right there instead of hiding until a second window shows up. And if you turned tabs off, the app now takes you at your word: New Tab and the + button are disabled instead of flashing a window at you.

One fix matters especially if you updated from an earlier version with your license already activated: the app could mistake that update for a brand-new install and switch tabs on without asking. Your setup is now recognized for what it is, and nothing changes under you.

Under the hood, live reload got tougher on slow and network volumes — a save that landed at exactly the wrong moment could freeze the preview until the next one — and Quick Look previews of very large documents are lighter on memory.

August 1, 2026
v1.6.0

Tabs, and front matter that reads like metadata

  • New: Documents open as tabs in a single window. ⌘T opens a new tab, and the setting lives in Settings ▸ General. Existing installs keep the previous behaviour until you turn it on.
  • New: YAML front matter is rendered as a Properties block at the top of the document rather than as loose text.
  • Fixed: Live reload stopped after the first save with editors that write atomically, such as Obsidian and VS Code. The document now keeps up with every save.
  • Fixed: A document that merely opened with a horizontal rule could have part of its text swallowed into a Properties block.
  • Fixed: `<details open>` blocks now render expanded instead of collapsed.
  • Fixed: Links using a javascript: scheme are no longer emitted in Quick Look previews.

Tabs are the change you will notice first. Open a second document and it joins the window you were already in, the way Finder and Safari behave, instead of stacking one more window on the pile. ⌘T opens a new tab, and the toggle sits in Settings ▸ General.

If you already have MacMD Viewer installed, nothing moves until you say so: existing installs keep the previous one-window-per-document behaviour, and the What's New screen offers a single click to switch. New installs get tabs from the start.

The second change is quieter but matters if you keep notes with YAML front matter. That block at the top of the file now renders as a labelled Properties section instead of leaking into the document as ordinary text.

Underneath, the fix worth calling out is live reload. If you edit in Obsidian, VS Code, or anything else that saves by writing a temporary file and renaming it into place, the preview used to update once and then quietly stop following along. It now keeps up with every save.

July 30, 2026
v1.5.2

Smoother file opening

  • Fixed: Markdown files could appear greyed out in the Open panel on Macs where another app registers its own type for .md. File types are now resolved at runtime.
  • Fixed: A crash that could occur when closing the Open from Path window.

Some Macs never showed the problem; on others, every .md file sat greyed out in the Open panel. The cause was a hard-coded file-type identifier that another installed app could override. MacMD Viewer now asks macOS at runtime which types are readable, so the Open panel works the same on every machine.

This update also fixes a crash when closing the Open from Path window.

July 23, 2026
v1.5.1

Local images in your documents

  • New: Images referenced with a relative path now render inside the document.
  • New: A clearer permission banner with a one-click way to grant access to an entire folder, so you approve once instead of file by file.

Markdown files often sit next to the images they reference — a screenshots/ folder, or an image beside the document. Those now display in place.

Because MacMD Viewer is sandboxed and never writes to your files, macOS requires your permission to read images outside the document itself. The banner makes that a single click for the whole folder, rather than a prompt per image.

July 17, 2026
v1.5.0

Onboarding and paired themes

  • New: A guided setup on first launch that walks you through opening files and making MacMD Viewer your default Markdown viewer.
  • New: Paired themes — pick a theme once and the matching light or dark variant applies automatically as your system appearance changes.
  • New: A /macmd skill for Claude Code, with a toggle to turn automatic file opening on or off.
  • Fixed: License keys pasted into the activation field now appear as typed.
  • Improved: Clearer, more readable onboarding text and layout.

Paired themes mean you no longer have to pick a theme twice. Choose Solarized, Nord or Tokyo Night once and the light variant shows in daylight, the dark variant at night, following whatever macOS is doing.

The first-launch walkthrough covers the two things new users most often miss: opening a file, and setting MacMD Viewer as the default app for Markdown.

July 6, 2026
v1.4.1

Working in-document links

  • Fixed: Links to headings within the same document now scroll to the correct place, including headings containing underscores and headings with an explicit {#id} anchor.

Long documents often link to their own sections — a table of contents, a "back to top" link, or a cross-reference. Those links now resolve correctly instead of doing nothing.

July 1, 2026
v1.4.0

Export to PDF and printing

  • New: Export as PDF (⌘P) — the PDF keeps your document theme and flows as one continuous page instead of breaking mid-content.
  • New: Native printing from the File menu, using the same themed layout.
  • New: Expand wide tables to full screen, the same way Mermaid diagrams already worked.
  • Fixed: Task lists (- [ ]) now render on a single line instead of pushing the text below the checkbox.

PDF export renders the document the way you are reading it — your selected theme, syntax highlighting, tables and diagrams all carry over. The page flows continuously rather than being cut into fixed sheets, so long code blocks and wide tables stay readable.

Printing uses the same layout, so what you send to a printer matches what you see on screen.

June 3, 2026
v1.3.0

Document themes

  • Nine document themes: Default, GitHub, Serif / Book, Sepia, Solarized Light, Dracula, Nord, Tokyo Night, and Atom One Dark.
  • Theme changes apply instantly to open documents without resetting scroll position.
  • Finder QuickLook previews use the same selected theme for newly generated previews.
  • Syntax highlighting follows the selected document theme.

Document themes change the full rendered document: background, typography, links, blockquotes, tables, inline code, code blocks, and syntax highlighting. Pick a theme in Settings or from the View menu, and the open document updates in place.

QuickLook reads the same preference, so new Finder previews match the app. Finder may keep older previews cached until macOS refreshes them.

May 9, 2026
v1.2.1

macOS Tahoe compatibility

  • Sparkle auto-update now fully compatible with the macOS Tahoe sandbox model
  • Smoother update flow for users on macOS 15 and later
May 9, 2026
v1.2.0

Security hardening

  • Sandbox grant flow for opening linked files (via standard macOS file picker)
  • Hardened file-link security: extension allowlist, symlink resolution, inert-document model
  • Closed image auto-load on non-local hosts (CSP tightening)
  • Improved <a> link handling, including SVG xlink:href edge cases
May 7, 2026
v1.1.7

License management & admin polish

  • Admin: license revocation system for refunded customers
  • Admin: balanced license table columns, added Revoke button + Revoked badge
  • Fixed duplicate heading highlights in the table of contents
  • Reduced keychain access prompts on startup
May 5, 2026
v1.1.6

Appearance settings

  • New: Appearance setting in Preferences (Follow System / Light / Dark)
  • Per-app override so MacMD Viewer can stay light while the system is dark (or vice versa)
  • Documented QuickLook appearance limitation in Settings
April 14, 2026
v1.1.0

Default app behavior & deploy reliability

  • Fixed: MacMD Viewer no longer overrides your default Markdown app on first launch
  • Improved deploy pipeline reliability (HTTP wake-up, SSH retries)
  • Sparkle auto-update signing pipeline hardened
March 15, 2026
v1.0.0

Initial Release

  • Native macOS Markdown viewer built with SwiftUI
  • Mermaid diagram rendering (flowcharts, sequence, state, Gantt, pie, class)
  • Syntax highlighting for all major programming languages
  • QuickLook extension for Finder preview
  • Live file watching with automatic reload
  • Light and dark mode following system appearance
  • Table of contents sidebar with scroll position tracking
  • Zoom controls with per-document persistence
  • URL scheme support (macmd://)
  • Apple Silicon native (Universal Binary)

Always getting better

One-time purchase. Every update included, forever.

See all features