Changelog

What's new

Version history and release notes for MacMD Viewer.

October 16, 2026
v1.8.0

Copy a code block in one click, and wrap long code lines

  • New: a Copy button appears when the pointer is over a code block. It copies the code exactly as written, without the ``` fence lines, and shows Copied for a moment. Diagrams have no Copy button, and the button is left out of printing and PDF export.
  • New: View ▸ Wrap Long Code Lines. Long lines in code blocks wrap inside the block instead of scrolling sideways. Off by default; the choice is kept for every document.
  • New: Settings ▸ Appearance ▸ Reading has a slider for the text column width, with a Default button, and the Wrap long code lines switch. They stay in step with the View menu.

Code blocks are often the part of a document you want to take somewhere else: a command to run, a config to paste, an example to try. Selecting the code by hand is fiddly, so each code block now has a Copy button. It appears at the top right when the pointer is over the block. One click copies the code as it is written in the file, without the fence lines around it, and the button says Copied for a moment.

A long line in a code block used to mean a horizontal scrollbar. If you'd rather see all of it at once, turn on View ▸ Wrap Long Code Lines: long lines wrap inside the block. The setting is off by default, and it changes the page in place without losing your scroll position.

Since 1.6.5 the View menu could make the text column narrower or wider. Settings ▸ Appearance now has a Reading section with a slider for that width, a Default button, and the wrap switch. A change in Settings shows up in the View menu, and the other way around.

Thanks to the reader who asked for the Copy button and the wrap option.

October 10, 2026
v1.7.0

Copy the Markdown source, open it in your editor, and see how long it is

  • New: Edit ▸ Copy as Markdown (⌥⌘C), also a button in the toolbar, copies the whole document's Markdown source, front matter included, exactly as it is in the file. ⌘C still copies the rendered text.
  • New: File ▸ Open in TextEdit (⇧⌘E; the menu names your editor), also the pencil button in the toolbar, opens the file in your text editor. You can choose the editor in Settings ▸ General. When you save there, the preview updates.
  • New: the word count and reading time sit at the bottom of the sidebar, under the table of contents. Code blocks, diagrams, images and front matter are not counted.
  • Improved: less space above headings in the reading window, as in Quick Look. 1.6.5 had only reduced the space below them.

MacMD Viewer shows Markdown; it does not edit it. But reading often leads to something else: pasting the text into a chat, fixing a typo, checking how long a page has become. These three changes make those steps shorter.

⌘C copies what you see, the rendered text. ⌥⌘C now copies the source instead: the whole file, front matter and all, byte for byte. The same command is a button in the toolbar, next to the pencil. It also works on a document you opened with New from Clipboard.

⇧⌘E opens the file you are reading in your text editor. If MacMD Viewer is your default app for .md files, it picks another editor rather than itself: the app your Mac uses for plain text, usually TextEdit. Settings ▸ General shows which editor is used, and lets you pick another one. Save in the editor and the preview follows, as it already did. The command is greyed out for a document that has no file, such as one created from the clipboard.

The bottom of the sidebar now shows how many words the document has, and how long it takes to read at 230 words per minute, rounded up to the next minute. Only the prose is counted.

The space above headings is also smaller. 1.6.5 brought each heading closer to the text below it, but left a wide gap above it in the reading window. That gap now matches the Quick Look preview.

Thanks to the readers who asked for these changes.

October 9, 2026
v1.6.5

Set the width of the text column, and headings sit closer to their text

  • New: View ▸ Narrower Text Column (⌃⌘[), Wider Text Column (⌃⌘]) and Default Text Column Width (⌃⌘0). The width is kept for every document, and the page keeps its scroll position.
  • Improved: less space below headings, so each heading reads as part of the text that follows it.

⌘+ and ⌘− already changed the size of the text, but nothing changed how wide the column was. On a large display, or with a long document, you may want a narrower column, or a wider one. ⌃⌘[ and ⌃⌘] now change the width step by step, and ⌃⌘0 sets it back to the width your theme uses. The commands are in the View menu. The setting applies to every document and is kept after you quit. PDF export and Quick Look previews keep their usual width.

The space below headings is also smaller. It was nearly as large as the space above them, so a heading could look like it belonged to neither block. Now each heading sits close to the text it introduces.

Thanks to the two readers who asked for these changes.

October 3, 2026
v1.6.4

Quick Look previews Markdown again when another app claims .md

  • Fixed: on Macs with recent Microsoft Word, CotEditor or Nova installed, pressing Space on a .md file in the Finder showed raw text instead of the rendered preview.

Some apps tell macOS that .md files are of the type public.markdown. Recent versions of Microsoft Word do, and so do CotEditor and Nova. Once one of them is installed, macOS files every .md under that name instead of the one Quick Look previews were registered for. The Finder then found no previewer for the file and fell back to plain text.

Reinstalling, resetting Quick Look or restarting the Finder did not help, because nothing was broken on your Mac: the preview simply did not list that type. It does now. Update, and press Space.

Thanks to the reader who reported it, with every check already done.

October 2, 2026
v1.6.3

Linked files keep opening after you rebuild your docs

  • Fixed: when a docs generator deleted and recreated its output folder, clicking a link to a file in that folder asked for access again after every build. The permission you granted is now renewed instead of thrown away.

Opening a linked file next to your document asks for permission to that folder, once. That was the promise, and it held — until the folder was rebuilt. Docs generators delete their output folder and write a fresh one on every run, and after each run the permission dialog came back.

Thanks to Georgi for the report, and for the screenshot that showed every file in the folder "added today": that was the clue.

The cause, for the curious: macOS remembers a folder you grant by its identity on disk, not only by its path. A folder recreated at the same path is a new folder, so the saved permission comes back flagged as out of date. MacMD Viewer was discarding it at that point. It now checks that access still works and, when it does, saves a fresh copy for next time.

September 6, 2026
v1.6.2

Your outline is no longer hiding under the tab bar

  • Fixed: with the tab bar showing, the top of the sidebar outline was covered by the bar, hiding the document's first heading. The outline now starts right below the bar, and follows along when you show or hide the bar.

If you open a document whose first heading is at the very top of the file, and the tab bar is showing, that heading was missing from the outline. It was not skipped — it was laid out underneath the bar, along with half of the second one. Hiding the tab bar brought it back, which is a fix nobody should have to find.

Thanks to Jeff for the report, and for two screenshots that pinned the symptom exactly.

The cause, for the curious: with the tab bar showing, macOS tells the sidebar it runs the full height of the window — because on a lot of apps the bar does start at the sidebar's right edge. Here it does not: the bar's background spans the whole window. The sidebar was reserving 44 points of room at the top while 80 were actually covered. It now measures the real chrome instead of the one macOS describes.

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