## You Got a .md File
Markdown Reader for Mac
A colleague sent you a .md file. Maybe it came from GitHub, an Obsidian export, or a project handoff. You double-clicked it and got a wall of # symbols and ** characters. Now what?
ShowMeMyMD is a native macOS markdown reader that opens any .md file and renders it beautifully — instantly. No code editor. No browser. No learning curve.
## What Is a .md File?
Plain text with formatting built in
A .md file is a Markdown file — a simple text document that uses symbols like # for headings and ** for bold text. Think of it like a Word document, but simpler and universal. Developers love it, but anyone can read one — with the right app.
You’ll find .md files everywhere: GitHub README files, Obsidian note exports, project documentation, API guides, meeting notes, and technical specifications. They’re the universal format for structured text — and all you need is a proper reader to make sense of them.
Want the full explanation? Read our guide to .md files. Or jump straight to our Markdown cheat sheet.
## The Problem
TextEdit makes Markdown unreadable
Double-clicking a .md file on Mac opens it in TextEdit by default. Instead of a nicely formatted document, you see raw syntax — hash marks, asterisks, brackets, and dashes everywhere. The content is there, but it looks like code.
What TextEdit shows you
# Project Overview
## Getting Started
**Important:** Follow these steps...
- Step one: install the thing
- Step two: configure the `settings.json`
You don’t need a code editor. You don’t need to learn Markdown syntax. You just need to read the document. Learn how to open .md files on Mac the right way, or set ShowMeMyMD as your default .md app.
## The Solution
ShowMeMyMD turns .md files into readable documents
ShowMeMyMD is like Preview.app, but for Markdown. Drop in a .md file and it renders instantly — headings, bold text, lists, code blocks, tables, all formatted exactly as the author intended. No setup. No learning curve.
Set it as your default .md app once, and every Markdown file you open will just look right. Built with native SwiftUI — not Electron — so it launches instantly and feels like a real Mac app.
## Built for Reading
Features designed for comfortable reading
ShowMeMyMD is purpose-built for people who need to read Markdown, not write code.
01
Sepia Theme
A warm, paper-like reading experience that’s easy on the eyes — especially for long documents. Like reading a book, not staring at a screen. Plus three more themes: System, Nord, and Solarized.
02
Clean Typography
Proper font sizing, line spacing, and margins that make long documents a pleasure to read. Headings, lists, and code blocks are all visually distinct.
03
Table of Contents
Long document? The built-in Table of Contents lets you jump to any section instantly. Great for project documentation, meeting notes, and guides.
04
Word Count & Read Time
See word count, line count, and estimated reading time at a glance. Know exactly how long that README or project brief will take to get through.
05
Syntax Highlighting
Over 20 programming languages highlighted in fenced code blocks. When you’re reading technical docs, code samples look exactly as the author intended.
06
GitHub Callouts
Full support for GitHub-style callouts — note, tip, important, warning, and caution blocks render with proper icons and colors.
## Who It’s For
A markdown reader for everyone, not just developers
You don’t need to be a programmer to encounter .md files. Here’s who uses ShowMeMyMD every day:
Project Managers & Team Leads
Your dev team sends project docs, specs, and READMEs as .md files. Now you can read them without asking someone to convert to PDF first.
Obsidian & PKM Users
Exported notes from Obsidian, Logseq, or other knowledge management tools are Markdown files. ShowMeMyMD lets you view Obsidian notes outside the app with proper formatting.
Technical Writers & Documentation Teams
Review Markdown drafts with proper rendering before publishing. See exactly how headings, tables, code blocks, and callouts will look. ShowMeMyMD is ideal for technical writers working with Markdown.
Anyone Who Gets Sent a .md File
A contractor delivered a README.md. A student submitted notes in Markdown. Your GitHub repo has documentation you need to read. ShowMeMyMD makes all of it instantly readable.
## Why Native?
A real Mac app, not a web wrapper
Many Markdown tools are Electron apps — web browsers disguised as desktop software. They use hundreds of megabytes of RAM and take seconds to launch. ShowMeMyMD is different.
Built with native SwiftUI, ShowMeMyMD launches in under a second, uses minimal memory, and runs natively on Apple Silicon without Rosetta. It respects your Mac’s appearance settings, supports standard keyboard shortcuts, and integrates with Finder just like any other native macOS app.
See how it compares to popular alternatives: vs VS Code · vs Typora · vs MacDown · vs Marked 2
## Copy & Share
Share Markdown without the syntax
Need to share the content of a .md file with someone who doesn’t use Markdown? Copy it as rich text with one click and paste it into emails, Google Docs, Slack, Notion, or any app that accepts formatted text. Headings, bold, lists, and links all come through perfectly.
No more copying raw syntax. No more reformatting by hand.
Popular use cases: Paste Markdown into Gmail · Markdown to rich text email · Markdown to Outlook
## FAQ
Frequently Asked Questions
How do I open a .md file on Mac?
Download ShowMeMyMD from the Mac App Store, then double-click any .md file. To make it your permanent default, right-click a .md file in Finder, select Get Info, choose ShowMeMyMD in the Open With dropdown, and click Change All. Every .md file will now open beautifully rendered.
What is a .md file?
A .md file is a Markdown file — a plain text document that uses simple symbols like # for headings and ** for bold text. Markdown is used everywhere: GitHub READMEs, Obsidian notes, project documentation, and technical writing. With a markdown reader like ShowMeMyMD, these files render into beautifully formatted documents.
Do I need to know Markdown syntax to use ShowMeMyMD?
No. ShowMeMyMD renders Markdown into formatted text automatically. You see headings, bold text, lists, tables, and code blocks — not raw symbols. It is designed for people who need to read .md files, not write code.
Can I copy the formatted content to paste into emails or Google Docs?
Yes. ShowMeMyMD lets you copy rendered Markdown as rich text with one click. Paste it into Gmail, Google Docs, Slack, Notion, or any app that accepts formatted text. Headings, bold, lists, and links all come through perfectly.
Does ShowMeMyMD work on Apple Silicon Macs?
Yes. ShowMeMyMD is built with native SwiftUI and runs natively on both Apple Silicon and Intel Macs. No Rosetta required. It launches instantly and uses minimal system resources.
Is ShowMeMyMD a subscription?
No. ShowMeMyMD is a one-time purchase of $2.99 from the Mac App Store. No subscription, no account, no telemetry. Buy it once and use it forever.
What Markdown features does it support?
ShowMeMyMD supports GitHub Flavored Markdown (GFM) including tables, task lists, fenced code blocks with syntax highlighting for 20+ languages, strikethrough, and GitHub-style callouts (note, tip, important, warning, caution).
## Learn More
Explore more about Markdown on Mac
What is a .md file? — The complete beginner’s guide to Markdown files
How to open .md files on Mac — Step-by-step guide with screenshots
Markdown Viewer for Mac — Full feature overview of ShowMeMyMD
Markdown Preview for Mac — Live preview with split view and sync scrolling
Preview GitHub README locally — See your README before you push
Best Markdown Editor for Mac — Why ShowMeMyMD is the editor Mac needs
Compare Markdown apps — See how ShowMeMyMD stacks up against alternatives
Set default .md app on Mac — Make every .md file open in ShowMeMyMD
Just want to read a .md file?
$2.99. One-time purchase. No subscription. No code editor required.
Download on theMac App Store$2.99 · macOS 14+