By Arthur Teboul//Updated /6 min read

MacMD Viewer vs Obsidian: Native Reader or Vault? (2026)

Verdict

MacMD Viewer wins if you just want to read .md files on Mac. Obsidian wins if you're building a personal knowledge base — and it's free for that, including at work. They're different tools for different jobs, and many people run both.

Obsidian is a free note-taking app, free for work too, built on Electron: your files live in a vault, with backlinks, a graph view and plugins. MacMD Viewer is a $19.99 one-time native SwiftUI reader: open any .md file anywhere on the Mac, or press Space in Finder for a Quick Look preview. Build notes in Obsidian; read files in MacMD Viewer.

How Does MacMD Viewer Compare to Obsidian?

FeatureMacMD ViewerObsidian
LaunchFast (native)Slower (Electron startup)
QuickLook preview from FinderYes (hit Space on any .md file)Yes (since 1.14, October 2026)
Mermaid diagramsYes (built-in, no plugin)Yes (reading view, no plugin)
LaTeX / math renderingNoYes (MathJax, built into core, no plugin)
Live file watchingYes (re-renders on change)Yes in the vault (not documented for outside files)
Opens Markdown your AI agent writes, on its ownYes (Claude Code, Cursor, Windsurf, via a setup script)Not documented
Setup before first fileOpen the file. Done.Create a vault; outside files then open in its window
EditingNo (viewer-only by design)Yes (full editor, Vim key bindings built in)
Knowledge graph + backlinksNoYes (graph view + bidirectional links)
Plugin ecosystemNoYes (8,900+ community plugins)
Works with files outside any folderYes (Downloads, Desktop, anywhere)Yes (since 1.14, "Open file from outside the vault")
Apple Silicon nativeYes (SwiftUI)Yes (Electron-on-ARM, since November 2020)
App size on disk16 MB293 MB
Memory footprintLight (native, no browser engine)Heavy (Electron + Chromium)
Price$19.99 one-timeFree for all use, incl. work (optional Sync from $4/user/mo)

Obsidian's official site: obsidian.md

How we compared

Last checked on : MacMD Viewer 1.8.0 against Obsidian 1.14.5 (desktop, released 22 October 2026). Obsidian's licence, Sync price, current version, plugin count, its built-in Mermaid and math support, its Quick Look preview and its opening of files from outside the vault were re-read on its official pricing page, blog, changelog, plugin directory, help pages and GitHub releases. The 293 MB install size was measured on an Obsidian 1.10.6 app bundle on macOS 26.3. We ran no speed or memory benchmark, so the launch and memory rows are qualitative. MacMD Viewer facts come from its 1.8.0 release.

Criteria

  • Price and licence, including use at work
  • Opening a single .md file from anywhere on the Mac, and Quick Look preview in Finder
  • Mermaid diagrams and math rendering
  • Editing, linking and plugins
  • Install size, framework (native or Electron) and Apple Silicon support

Sources

$19.99 one-time · 14-day money-back · No subscription

What Does Each Tool Cost Over Time?

PeriodMacMD ViewerObsidian
Purchase price$19.99Free for all use, incl. work (optional Sync from $4/user/mo)
After 1 year$19.99Free for all use, incl. work (optional Sync from $4/user/mo)
After 3 years$19.99Free for all use, incl. work (optional Sync from $4/user/mo)

Both MacMD Viewer and Obsidian are one-time purchases. No recurring costs.

When is the free app enough?

If you keep notes in a vault, Obsidian is enough, free for work too, and since 1.14 it previews Markdown in Finder as well. The $19.99 buys a 16 MB reader that never edits: no vault to create, any .md file opens in its own window, Markdown written by Claude Code, Cursor or Windsurf can open in it automatically through a setup script, and PDF export keeps Mermaid diagrams and highlighted code. A direct purchase is refundable within 14 days.

What Are the Pros and Cons?

MacMD Viewer

Pros

  • +Native SwiftUI built for Apple Silicon
  • +16 MB installed vs Obsidian's 293 MB — no bundled Chromium
  • +QuickLook extension — preview any .md file from Finder with Space
  • +Mermaid diagrams render natively, no plugin required
  • +Live file watching — re-renders when the file changes
  • +Opens the Markdown that Claude Code, Cursor or Windsurf writes as soon as it is written (optional setup script)
  • +Zero setup — open a file, read it, move on
  • +One-time $19.99 — no subscription, no account, no sync paywall

Cons

  • -No editing capability (viewer-only by design)
  • -No LaTeX or math rendering (Obsidian does this in core)
  • -No knowledge graph, backlinks, or vault structure
  • -Single Mac focus (no Windows, Linux, or mobile)
  • -No plugin ecosystem

Obsidian

Pros

  • +Industry-leading knowledge management on Mac
  • +Bidirectional [[wiki links]] and graph view
  • +Free for every use, including commercial work, since February 2025
  • +8,900+ community plugins (Dataview, Templater, Git sync, Excalidraw) — counted 17 October 2026
  • +LaTeX math (MathJax) and Mermaid render in core, no plugin needed
  • +Vim key bindings built into the editor, no plugin needed
  • +Cross-platform (Mac, Windows, Linux, iOS, Android)
  • +Local-first storage, your notes stay on disk as plain .md files
  • +Since 1.14 (October 2026), opens .md files from outside the vault and renders them in Finder's Quick Look, even with Obsidian closed
  • +Actively developed — desktop v1.14.5 shipped 22 October 2026

Cons

  • -293 MB installed on disk — Electron + Chromium under the hood
  • -Heavy idle RAM with plugins enabled (Electron baseline)
  • -Vault-first — a file from outside the vault opens in a vault window, next to your notes
  • -Setup overhead (folder structure, plugins, templates) before it pays off
  • -Sync across devices is a paid add-on ($4/user/month billed annually, $5 monthly)
  • -Overkill for read-only Markdown workflows

When Should You Choose Obsidian vs MacMD Viewer?

Choose Obsidian if:

  • →You need to write and edit Markdown files, not just read them
  • →You work across Mac, Windows, and Linux
  • →You prefer a WYSIWYG or split-pane editing experience

Choose MacMD Viewer if:

  • →You primarily read and review Markdown files, not write them
  • →You want QuickLook preview: press Space in Finder to see any .md file rendered
  • →You need Mermaid diagram rendering without plugins or configuration
  • →You want a native macOS app that launches instantly and uses minimal resources

$19.99 one-time · 14-day money-back · No subscription

MacMD Viewer vs Obsidian: Same File, Different Job

For reading .md files on Mac, MacMD Viewer wins — a native SwiftUI reader with zero vault setup, which can open the files your AI agent writes as soon as they are written. For building a personal knowledge base with linked notes and a plugin ecosystem, Obsidian wins.

Obsidian is a knowledge management platform — you set up a vault, link notes together, install plugins, build a personal graph of ideas. Useful if that's the job. Overhead if you just opened the app to read one file that arrived in your Downloads folder or out of an AI agent session.

MacMD Viewer does the smaller job: open .md files fast, render them cleanly, get out of the way. This page compares the two on what matters when you're choosing one — or both — for your Mac workflow. Everything on the Obsidian side was re-verified on 29 July 2026, and again on 30 October 2026 after Obsidian 1.14 added Quick Look; the sources are listed at the bottom.

Where Obsidian Wins

For knowledge management, Obsidian wins: the vault model — bidirectional [[wiki links]], graph view, daily notes, templates — turns plain Markdown into an interconnected knowledge graph. Two things people often assume are plugins ship in core: math through MathJax ($$…$$ blocks, $…$ inline) and Mermaid diagrams both render with nothing installed. On top of that sits a community marketplace of 8,976 plugins (counted on obsidian.md/plugins on 17 October 2026) covering Dataview, Templater, Git sync and Excalidraw. For vault-based work it is industry-leading.

It is also free for that work. Since February 2025, Obsidian is free for every use including commercial use — see the pricing section below, because this page got that wrong for two months and the correction matters more than the comparison.

Performance on Mac is good for what it does, and the project is actively shipping: the 1.14 public release (5 October 2026) added Quick Look previews and opening .md files from outside the vault, and desktop v1.14.5 followed on 22 October 2026. Large vaults are its design target, and Electron is the runtime cost of cross-platform reach and the plugin ecosystem, not a bottleneck for the vault use case. No published, reproducible vault-load benchmark exists to quote here, so this page quotes none.

If you maintain interlinked notes, run Dataview queries, embed LaTeX equations, or rely on plugins like Excalidraw or Templater, Obsidian earns its 293 MB footprint and Electron memory cost. That's the wrong shape for reading a file, but the right shape for building a second brain.

Where MacMD Viewer Wins

MacMD Viewer is the right answer when you want to read Markdown, not manage it. Native SwiftUI, compiled for Apple Silicon, 16 MB on disk from a 5.4 MB download — no bundled Chromium, unlike Obsidian's Electron base. Mermaid diagrams render natively without plugins. An optional setup script hooks Claude Code, Cursor and Windsurf so the Markdown they write opens in MacMD Viewer as soon as it exists, and the open file re-renders each time the agent saves it.

The viewer-only constraint is intentional. No editing UI means no toolbar clutter, no plugin configuration, no vault decisions. Open the file, scan the content, close it. For the 80%+ read-only workflows that dominate 2026 — AI agent output review, README inspection, shared docs, project specs — that's the right shape.

If you've ever installed Obsidian, spent an hour on plugins, and discovered most of your .md files never end up in the vault anyway, MacMD Viewer is the lighter answer.

Feature-by-Feature Breakdown

Footprint and Performance

For footprint and performance, MacMD Viewer wins: 16 MB installed versus Obsidian's 293 MB Electron bundle, faster launch, and no bundled Chromium.

Two different numbers get confused here, so both are measured rather than quoted. Obsidian's Mac app occupies 293 MB on disk once installed (du -sh /Applications/Obsidian.app, v1.10.6, measured 29 July 2026). The official v1.12.7 disk image is a 203.5 MB download (GitHub release asset, 23 March 2026). The "213 MB" figure repeated across download directories — including the MacUpdate listing — is a listed download size, not an installed footprint, and an earlier version of this page presented it as the latter. MacMD Viewer, measured the same way on the same machine, is 16 MB installed from a 5.4 MB DMG.

Idle memory is heavy and grows with plugins, a recurring theme in long-running Obsidian Forum threads. Launch is slower because Chromium spins up first.

The ~18× install-size gap exists because Electron bundles its own copy of Chromium. SwiftUI doesn't.

QuickLook Integration

Both apps now render a .md file when you press Space on it in Finder. MacMD Viewer's Quick Look extension shows headings, code blocks, Mermaid diagrams and tables, in the document theme you picked in the app.

Obsidian added its own in the 1.14 public release of 5 October 2026. Its changelog reads: "On macOS you can use Quick Look previews for Markdown files even when Obsidian is closed." An earlier version of this page said Obsidian shipped no Quick Look extension; that was true of the 1.10.6 bundle we measured in July 2026 and stopped being true with 1.14. Corrected 30 October 2026.

So Quick Look is no longer a reason to pick one over the other. If you already run Obsidian 1.14 or later, Space in Finder is covered. For a full list of apps that ship a Markdown Quick Look extension, free ones included, see Markdown Quick Look on Mac.

Mermaid Diagrams

Both apps render Mermaid diagrams natively. MacMD Viewer renders inline in any open file. Obsidian renders Mermaid in reading view without requiring a plugin.

The path to a rendered diagram differs: MacMD Viewer renders Mermaid inline in any open file as a native app. Obsidian adds the Electron startup overhead and the vault requirement before the first Mermaid block appears.

For Mermaid coming from AI agents (Claude, Cursor, GitHub Copilot output .md files with Mermaid daily in 2026), see our view AI Markdown output on Mac guide for the full workflow.

LaTeX and Math

Obsidian wins this outright, and it wins it in core. Math expressions use MathJax with LaTeX notation — $$…$$ for display blocks, $…$ inline — with no plugin to install and no setting to flip.

MacMD Viewer does not render LaTeX or math at all. A $$…$$ block appears as literal text. If your .md files carry equations, that is a hard reason to pick Obsidian, or to keep it open alongside the viewer.

Knowledge Management

This is Obsidian's home turf and not a MacMD Viewer feature. Obsidian's [[wiki links]], graph view, backlinks panel, daily notes, and plugin ecosystem (Dataview, Templater, etc.) turn Markdown into a personal knowledge management system.

MacMD Viewer makes no attempt to compete. It is a viewer. If your workflow centers on connecting notes into a graph, use Obsidian. If your workflow is reading individual files, MacMD Viewer is lighter and faster.

Editing

MacMD Viewer has zero editing capability. Read-only by design.

Obsidian is a full Markdown editor with live preview, source mode, extensive customization, and Vim key bindings built into core — Settings → Editor → Advanced → Vim key bindings, no plugin required. The community Vim plugins in the official directory extend that built-in mode rather than replace it; Vimrc Support even tells you to turn the core setting on first. For writing Markdown, Obsidian is far better. For reading it, the editing UI is overhead.

The common pattern: write in your editor of choice (VS Code, Cursor, Typora, or Obsidian itself), preview in MacMD Viewer with live file watching for distraction-free reading.

Live File Watching

MacMD Viewer re-renders the open file whenever Cursor, VS Code, a coding agent or any other app saves it, wherever the file lives.

Obsidian watches the files in its vault. Since 1.14 it can also open a .md file from outside the vault, but its changelog doesn't say whether such a file re-renders when another app saves it, so this page makes no claim either way.

What Obsidian doesn't document at all is opening a file on its own the moment an agent writes it. MacMD Viewer's optional setup script adds that for Claude Code, Cursor and Windsurf (see AI tool integrations).

Pricing

MacMD Viewer is $19.99 one-time. No subscription, no account, no sync paywall. You buy the app, you own the app, and updates are free within the current major version.

Obsidian is free — for everything. Since 20 February 2025 the commercial licence is optional: Obsidian's own announcement is titled "Obsidian is now free for work" and states that anyone can use Obsidian for work, for free. The licence page now grants personal, commercial and non-profit use at no cost, and the pricing FAQ answers it directly: no, you are not required to pay for a commercial licence. The $50/user/year Commercial licence still exists, but as a support tier, not a gate.

An earlier version of this page said commercial use required that $50/year licence, and derived a "$146/year" ceiling from it. Both were wrong, and had been wrong since before this page was published. Verified and corrected 29 July 2026.

What actually costs money is optional and additive: Sync at $4 per user per month billed annually, or $5 billed monthly; Publish from $8/month per site; and a one-time $25 Catalyst badge for early builds. For one person who wants Sync, that is $48 a year billed annually. For most people it is $0.

So the honest framing is not "one-time purchase versus subscription". It is: Obsidian costs nothing until you want its hosted sync, and MacMD Viewer costs $19.99 once and never again. Pick on job fit, not on price. If sync matters but you want it free, Joplin handles that via Dropbox/WebDAV/S3 self-hosting. See our Obsidian alternative on Mac for the broader landscape.

When to Pick MacMD Viewer

  • 80%+ of your .md interactions are read-only (AI agent output, READMEs, project docs)
  • You want the Markdown your AI agent writes to open by itself and re-render as it changes
  • You want a native Mac app, not Electron
  • You don't need a knowledge graph or backlinks
  • You want to read .md files without setting up a vault first
  • You want the app to weigh 16 MB, not 293 MB

When to Pick Obsidian

  • You're building a personal knowledge base
  • You want bidirectional links and a graph view
  • You need LaTeX math — Obsidian renders MathJax in core, MacMD Viewer doesn't render it at all
  • You rely on plugins (Dataview, Templater, Excalidraw, Git sync)
  • You write papers with citations — though for that job, also look at Zettlr, a free academic Markdown editor
  • You need cross-platform sync across Mac, Windows, Linux, iOS, Android
  • You write Markdown daily and want an integrated editor + preview workflow, including Vim key bindings
  • Budget is the constraint: Obsidian is free for any use, including work
  • The Electron overhead doesn't bother you for the vault use case

When to Run Both

The most common 2026 setup for Mac users who have a vault AND consume AI agent output: Obsidian for the vault, MacMD Viewer for everything outside it. Vault notes stay in Obsidian. Ad-hoc .md files (Claude output, downloaded READMEs, project specs, shared docs) get rendered by MacMD Viewer. Both tools, doing their respective jobs.

Elias Bourgess, for example, describes keeping his runbooks, SRE study notes, postmortems and article highlights as plain Markdown in an Obsidian vault (his daily driver is a MacBook Pro M4), which is a good reason to keep Obsidian for a vault you build and search over time. If your setup looks like that, I'd add MacMD Viewer alongside it for the Markdown files that live outside the vault, such as READMEs and docs in project folders, so you can read them without importing them.

For the broader argument see our Obsidian alternative on Mac — the article frames "alternative" as "complement" rather than "replacement" for many use cases.

Verdict

If you're choosing one, pick by job:

  • Reading .md files → MacMD Viewer ($19.99 one-time)
  • Building a knowledge vault → Obsidian (free, including for work)

If you're choosing both, that's the cleanest setup. Obsidian for vault work. MacMD Viewer for the read-only stream that doesn't belong in any vault. The 16 MB native app sits in the dock with negligible cost — there's no reason it can't coexist with a 293 MB Electron vault tool when they serve different jobs.

What Was Verified, and When

Every Obsidian claim on this page was checked on 29 July 2026, price, version and plugin count again on 17 October 2026, and Quick Look, files outside the vault, licence and version again on 30 October 2026:

  • Licence — free for all use, including commercial, since 20 February 2025: obsidian.md/blog/free-for-work, obsidian.md/license, and the pricing FAQ.
  • Paid add-ons (re-checked 17 October 2026) — Sync $4 per user per month billed annually ($5 monthly), now a single tier; Publish from $8/month; Catalyst $25 one-time: obsidian.md/pricing.
  • Latest release (re-checked 30 October 2026) — desktop v1.14.5, published 22 October 2026: the obsidianmd/obsidian-releases GitHub release. On 29 July 2026 it was v1.12.7, a 203.5 MB DMG.
  • Quick Look and files outside the vault (checked 30 October 2026) — the 1.14 public release of 5 October 2026 on obsidian.md/changelog: "You can now open individual Markdown files from outside your vault in Obsidian, and preview them on macOS using Quick Look."
  • Installed size — 293 MB on disk, measured locally on Obsidian v1.10.6.
  • Plugin count (re-checked 17 October 2026) — 8,976 plugins listed on obsidian.md/plugins; 6,142 on 29 July 2026.
  • Core features — LaTeX/MathJax math per Obsidian's "Advanced formatting syntax" help page; Vim key bindings per Settings → Editor → Advanced and the community Vim plugins that document extending it.

Three claims from the previous version of this page did not survive that check and have been removed: that commercial use requires a $50/year licence, that LaTeX and Vim mode come from plugins, and that "a 10 GB vault loads in under 3 seconds on M1 per Obsidian's own release notes" — the release notes contain no such statement, so the number is gone rather than re-sourced.

On 30 October 2026 two more went: that Obsidian ships no Quick Look extension, and that it only opens files inside a vault. Both were true when checked in July and stopped being true with Obsidian 1.14.

For the full Mac Markdown app landscape, see our Markdown apps for Mac roundup. For the specific case of viewing AI agent output, see our view AI Markdown output on Mac guide.

Both apps render CommonMark-compliant Markdown with GitHub Flavored Markdown extensions including tables and task lists.

Frequently Asked Questions

Is Obsidian or MacMD Viewer better for Mac in 2026?

Different tools for different jobs. MacMD Viewer is better if you mainly read .md files (AI agent output, READMEs, shared docs) — it's a 16 MB native SwiftUI reader that opens any .md file with no vault, and can open what your AI agent writes as soon as it writes it. Obsidian is better if you're building a personal knowledge base with bidirectional links and a plugin ecosystem, and it's free for that, including for commercial work. Many users run both.

Is Obsidian native on Apple Silicon?

Yes, since November 2020 — Obsidian 0.9.17, released 21 November 2020, shipped the first native Apple Silicon build. But the app remains Electron, meaning Chromium is still under the hood. Native means the binary is compiled for ARM, not that the runtime is light. Hence the 293 MB installed footprint.

How much RAM does Obsidian use on Mac compared to MacMD Viewer?

Obsidian's Electron baseline carries a heavy idle memory footprint, which grows with plugins and vault size (Obsidian Forum, 2026). MacMD Viewer's native SwiftUI runtime has no bundled Chromium, so it stays far lighter before either app opens a file.

Do I need a paid commercial licence to use Obsidian at work?

No. Since 20 February 2025 the commercial licence is optional — Obsidian's own announcement reads 'Anyone can use Obsidian for work, for free', and the licence page grants personal, commercial and non-profit use at no cost. The $50/user/year Commercial licence still exists as a support tier, not as a requirement. Only Sync ($4/user/month billed annually, $5 monthly) and Publish (from $8/month) cost money, and both are optional. Verified 17 October 2026.

Can I open Obsidian .md files in MacMD Viewer?

Yes. Obsidian files are plain Markdown — MacMD Viewer renders them like any other .md file. Obsidian-specific syntax like [[wiki links]] and Dataview blocks appear as plain text, and LaTeX math blocks are not rendered, but the prose, headings, code, tables, and Mermaid diagrams render identically.

Does Obsidian have a QuickLook extension on Mac?

Yes, since Obsidian 1.14 (public release, 5 October 2026). Its changelog reads: 'On macOS you can use Quick Look previews for Markdown files even when Obsidian is closed.' Earlier versions shipped none. MacMD Viewer also ships one, so both apps render a .md file when you press Space in Finder. Verified 30 October 2026 on obsidian.md/changelog.

Should I use MacMD Viewer alongside Obsidian?

Many users do exactly that. Obsidian for the vault and knowledge graph; MacMD Viewer for ad-hoc .md viewing outside the vault (Claude/Cursor output, downloaded READMEs, project docs, shared specs). The tools complement each other — viewer for reading, vault for building.

Compare MacMD Viewer with other Mac Markdown apps

vs Glowvs MacDownvs Markdown Better Viewvs Marked 2vs Marked QLvs MarkTextvs MD-Viewervs MDHerovs Mevavs QLMarkdownvs Readdownvs Telescopovs Typoravs Zettlr

Ready to try MacMD Viewer?

MacMD Viewer is a native SwiftUI Markdown viewer: it renders any .md file with Mermaid diagrams, syntax highlighting and a Quick Look extension for Finder. $19.99 one-time, with no subscription and no account. See all MacMD Viewer features.