Markdown Viewer for Mac

A free, native Markdown viewer and reader for macOS. Open any .md file from Finder, iCloud, Dropbox, or a Git repo — render GitHub-flavored Markdown instantly with auto table of contents, syntax highlighting, and live WYSIWYG editing. 100% offline, no setup.

Download for Mac

Free • Offline • macOS 10.13+

The Free Markdown Viewer for macOS

MarkViewer is a lightweight Markdown reader and editor for Mac. Double-click any .md file in Finder and it opens — no IDE, no browser, no uploads. The rendered view is the edit view, so you can preview Markdown and make quick fixes in the same window.

If you've been searching for a clean Markdown viewer for Mac — this is it.

WYSIWYG Editing for Markdown

MarkViewer applies formatting instantly as you type markdown syntax. No separate preview pane needed. See exactly how your markdown will render, right as you write.

✍️ Real-time Rendering

Type markdown syntax and see it rendered instantly. Headings, bold, italic, links — all formatted as you write.

📑 Table of Contents

Automatically generated TOC from your headings. Navigate long documents with ease.

💻 Code Syntax Highlighting

Code blocks are highlighted with proper syntax coloring. JavaScript, Python, Go, and more.

📊 Tables & Task Lists

Full GitHub Flavored Markdown support. Tables, checklists, strikethrough — all rendered perfectly.

🚀 Lightweight & Fast

Launches in under a second. No workspace loading. Just open your .md file and start writing.

🔒 Offline & Private

Everything runs locally. No cloud, no uploads, no tracking. Your documents stay on your Mac.

MarkViewer markdown preview showing real-time WYSIWYG editing on macOS

Perfect for Quick Edits

MarkViewer isn't trying to replace a full writing environment or your main code editor. It's for when you need to:

How to View and Open Markdown Files on Mac

Three steps from a fresh download to a fully rendered .md file.

  1. Download and install MarkViewer. Grab the universal DMG from the download section below or the GitHub Releases page. The installer is signed and notarized — drag MarkViewer.app into Applications and launch.
  2. Open any .md file. Double-click a markdown file in Finder, drag it onto the MarkViewer dock icon, or use ⌘O from inside the app. The file renders immediately — headings, tables, task lists, and fenced code blocks formatted the way GitHub renders them.
  3. (Optional) Make MarkViewer the default app for .md. In Finder, right-click any markdown file → Get InfoOpen With → choose MarkViewer → click Change All…. From then on, every .md file you open from Finder, Spotlight, or another app lands in MarkViewer.

MarkViewer requires macOS 10.13 or later and runs as a universal binary on both Apple Silicon and Intel Macs.

Markdown Features That Render Correctly

MarkViewer supports the GitHub Flavored Markdown (GFM) feature set, so what you see while editing matches what GitHub renders for the same file. There is no separate preview pane — the rendered view is the edit view.

📋 Tables & task lists

Pipe-delimited tables, alignment markers (:---:), and - [ ] task lists render exactly as they do on GitHub, including nested checklists and mixed-indent lists.

💻 Fenced code blocks

Triple-backtick code blocks are syntax-highlighted for over 100 languages — JavaScript, TypeScript, Python, Go, Rust, Shell, SQL, YAML, and more. Click to copy any block.

📊 Mermaid diagrams

Flowcharts, sequence diagrams, ER diagrams, and class diagrams render inline from ```mermaid blocks. No external service round-trip and no internet required.

🔗 Auto-links & references

Bare URLs become clickable. Reference-style links ([label][ref]), inline images, and footnotes resolve correctly. External links open in your default browser.

✏️ Emphasis & inline code

The full GFM emphasis set: bold, italics, strikethrough, and inline code — all formatted live as you type the syntax.

🔢 Heading anchors & TOC

Each heading produces a stable anchor used by the auto-generated table of contents in the left rail. Click any TOC entry to jump; the active heading updates as you scroll.

Open Markdown Files from iCloud, Dropbox, or External Drives

MarkViewer reads from any location your Mac can reach. Files stay in their original folder — MarkViewer does not copy them into a separate workspace, so changes you save sync back through whichever cloud provider hosts the file.

Files are loaded locally and never uploaded to any MarkViewer server. The app itself runs 100% offline — opening a Dropbox-hosted file does not send its contents anywhere except back to Dropbox when you save.

Keyboard Shortcuts

MarkViewer is built around a small, memorable shortcut set so you rarely need to reach for the mouse. All shortcuts can be remapped from ⌘, Settings.

Shortcut Action
⌘OOpen a markdown file
⌘NNew file in a new tab
⌘SSave the current file
⌘⇧SSave As…
⌘FFind within the document
⌘⇧EToggle the file explorer (Finder pane)
⌘⇧LToggle the table of contents
⌘⇧RAdd an inline review comment to the selected text
⌘⇧↵Open the AI review prompt panel
⌘1⌘9Switch to tab 1–9 (⌘9 jumps to the last tab)
⌘,Open Settings (Privacy, Shortcuts, Update channel)

How MarkViewer compares to other Markdown viewers on Mac

MarkViewer is one of several ways to read and render .md files on macOS. Here's where it fits alongside the common alternatives.

Alternative Best for MarkViewer's lane
Full-featured Markdown editors Long-form writing and notebooks Quick preview without the weight of a full writing environment
Code editors with Markdown plugins Devs already living inside an IDE Launches in under a second, no workspace to load
Browser-based / online previewers One-off rendering with no install Fully offline — files never leave your Mac
Built-in macOS preview utilities Viewing plain text quickly Proper GFM rendering (tables, task lists, Mermaid) plus inline AI review handoff

Where MarkViewer is specialized: lightweight real-time preview for local .md files, with an inline AI review loop for handing annotated drafts off to Claude, ChatGPT, or Cursor in one keystroke.

NEW IN v1.3

Bonus: Optional AI Review Loop

If you regularly read AI-generated Markdown, MarkViewer adds an optional handoff layer on top of the viewer. Highlight a passage, leave an inline comment with ⌘⇧R, press ⌘⇧↵, and paste the generated prompt into Claude, ChatGPT, Cursor, Gemini, or Copilot. Optional, never required — the core app stays a clean Markdown viewer.

📝 Inline Annotations

Press ⌘⇧R on any selection to leave a review comment. Annotations are stored as HTML comments inside the markdown, so they survive save/reload and don't affect rendering.

🎯 Editable Prompt Panel

Press ⌘⇧↵ to open a floating panel with the rendered prompt. Edit freely, save as your default template, or reset.

🤖 Works with Any AI

Claude, ChatGPT, Cursor, GitHub Copilot, Google Gemini, Codex CLI, local LLMs — if it accepts pasted text, it works. No API key, no internet requirement inside MarkViewer.

🔐 Explicit Clipboard

MarkViewer never hijacks your clipboard. The prompt is only copied when you click Copy — no surprises, no stolen focus.

The pitch: AI writes drafts, humans review them. Until now, reviewing a Claude-generated README meant copy-pasting chunks back and forth. The AI Review Loop keeps your annotations attached to the file and makes the handoff one keystroke.

Common Questions

How do I preview .md files on Mac?

Install MarkViewer, then double-click any .md file or drag it onto the app icon. You'll see the rendered Markdown — headings, lists, tables, code blocks, task lists — with no browser and no internet connection. You can also set MarkViewer as the default app for .md files in Finder's Get Info panel.

Does MarkViewer support live, real-time Markdown preview?

Yes. MarkViewer renders Markdown as you type — headings, bold, italics, lists, tables, and code blocks format instantly. There is no separate preview pane to toggle; the rendered view is the edit view.

Can MarkViewer preview Markdown from iCloud, Dropbox, or external folders?

Yes. MarkViewer reads any .md file you have access to on your Mac, including iCloud Drive, Dropbox, Google Drive, and external volumes. Files are loaded locally — nothing is uploaded.

Can I use MarkViewer to edit AI-generated markdown?

Yes! When Claude or ChatGPT generates markdown content, you can save it as a .md file and edit it in MarkViewer. The WYSIWYG editor makes it easy to fix formatting or add your own notes.

How is this different from a browser-based markdown previewer?

MarkViewer is a native macOS app that works 100% offline. No internet required, no files uploaded to servers. It's also faster than browser tools and integrates with your Mac's file system.

Is the preview accurate to GitHub's rendering?

MarkViewer supports GitHub Flavored Markdown (GFM) including tables, task lists, and code syntax highlighting. The rendering is very close to what you'll see on GitHub.

Can I export to HTML or PDF?

MarkViewer focuses on viewing and editing Markdown files, not exporting them. For PDF or HTML output, consider a dedicated conversion tool. MarkViewer's strength is being lightweight and fast for everyday Markdown preview and review.

Can MarkViewer send markdown to Claude or ChatGPT for review?

Yes — MarkViewer's AI Review Loop lets you annotate any passage, then press ⌘⇧↵ to open an editable prompt panel. Copy the prompt into Claude, ChatGPT, Cursor, Gemini, or any AI assistant.

Does the AI review loop require an internet connection?

No. MarkViewer itself is 100% offline and never contacts any AI service. You paste the generated prompt into whichever AI tool you already use — the review loop is a handoff, not an integration.

Download the Free Markdown Viewer for Mac

Open and read .md files on macOS the simple way. Free for macOS 10.13 and later.

Download for Mac (Free)

Universal Binary (Intel & Apple Silicon)

← Back to Home