What is a .md File? How to Open Markdown Files on Mac & Windows (2026)

Someone just sent you a file ending in .md and you have no idea what to do with it. You’re not alone. This is one of the most common file types in tech — and increasingly outside of it — but most operating systems still don’t handle it well out of the box. Here’s everything you need to know.

What is a .md file?

A .md file is a plain text file written in Markdown, a lightweight formatting language. The .md file extension simply stands for “Markdown” — so when people ask what is a Markdown file, the answer is: this exact thing.

Think of it like this: a .docx file is a Word document, a .pdf is a PDF, and a .md is a Markdown document. The difference is that you can open a .md file in any text editor — it’s just text. But unlike a plain .txt file, it contains simple formatting instructions that are meant to be rendered into nicely formatted output with headings, bold text, lists, links, and more.

The key idea behind Markdown is that the source text should be readable on its own, even without rendering. You don’t need special software to understand what’s going on — the formatting symbols are intuitive.

What Markdown actually looks like

If you open a .md file in a basic text editor, you’ll see the raw formatting symbols. Here’s what common Markdown looks like:

# This is a heading

This is a regular paragraph with **bold text** and *italic text*.

- This is a list item
- Another list item
- A third one

[This is a link](https://example.com)

> This is a blockquote — often used for callouts or quotes.

Those symbols — the #, the **, the -, the > — are formatting instructions. They tell a Markdown renderer how to display the text. A # becomes a large heading. **bold** becomes bold. - item becomes a bullet point.

When a Markdown viewer or website renders this file, you see clean, formatted text — not the raw symbols. The gap between “raw” and “rendered” is exactly why you need the right markdown file viewer to open .md files comfortably.

Why .md files are everywhere

A few years ago, .md files were mostly a developer thing. You’d find them on GitHub as README.md files explaining how to use a project. That was about it.

Not anymore. Markdown has gone mainstream, and here’s why:

• GitHub and GitLab — Every open-source project has a README.md. If you’ve ever visited a GitHub repository, you’ve read rendered Markdown.
• AI output — ChatGPT, Claude, Gemini, and other LLMs format their responses in Markdown. When you export a conversation or save a response, it’s often a .md file.
• Note-taking apps — Obsidian, Logseq, Bear, and many others use Markdown as their native format. Your notes are .md files under the hood.
• Documentation — Technical docs, API references, internal wikis, and product specs are increasingly written in Markdown.
• Blogs and writing — Static site generators like Astro, Hugo, and Jekyll use Markdown for blog posts. Many writers draft in Markdown before publishing elsewhere.

The result: even if you’re not a developer, there’s a good chance .md files are showing up in your work. A colleague shares meeting notes. An AI assistant saves a summary. A contractor sends a spec. And your computer just… opens it as raw text.

How to open .md files on Mac

macOS doesn’t render Markdown natively. Double-click a .md file and you’ll get TextEdit showing raw symbols. You’ll need a real .md file viewer or a dedicated Mac Markdown app to render it properly. Here are your options, from basic to best (for the full breakdown, see our complete Mac guide):

TextEdit (built-in)

Double-clicking a .md file usually opens TextEdit. You’ll see the raw Markdown source — pound signs, asterisks, and all. It’s technically readable, but not pleasant. You’re reading the formatting instructions instead of the formatted output.

Quick Look

Select a .md file in Finder and press Space. Quick Look shows a preview, but for Markdown files it’s just raw text again — no rendering. You can install the QLMarkdown plugin via Homebrew to fix this, but it requires Terminal commands and permissions configuration.

VS Code

If you have VS Code installed, it can render Markdown with Cmd+Shift+V. The rendering is solid, but VS Code is a full IDE — over 400MB — and launching it just to read a file feels like driving a semi-truck to the corner store. It’s the right tool for writing code, not for reading a README.

MDHero (native viewer)

MDHero is a lightweight native Markdown viewer and Markdown reader built specifically for viewing .md files. Double-click a Markdown file, see rendered output instantly. It supports syntax highlighting, math equations, diagrams, and dark mode — all in an app under 8MB.

The advantage of a dedicated .md file viewer is that you can set it as your default app for Markdown files. Right-click any .md file in Finder, choose Get Info, expand Open with, select MDHero, and click Change All. From that point on, every .md file opens rendered — no extra steps.

How to open .md files on Windows

Windows has the same fundamental problem as Mac: no built-in Markdown rendering. You’ll need a proper .md file opener or a Windows Markdown app to read these files comfortably (for the deep dive, see our complete Windows guide). Here’s what works:

Notepad

Windows opens .md files in Notepad by default. You’ll see raw text. It works for a quick glance, but you’re reading formatting syntax, not formatted text.

VS Code

Same story as Mac — VS Code renders Markdown well with Ctrl+Shift+V, but it’s a heavyweight IDE. If you already have it open for coding, it’s convenient. If you just want to read a file someone sent you, it’s overkill.

MDHero (native viewer)

MDHero runs natively on Windows 10 and later as a free Markdown viewer and .md file opener. Install it, then set it as the default handler:

1. Right-click any .md file
2. Choose Open with then Choose another app
3. Select MDHero
4. Check Always use this app to open .md files

That’s it. Every .md file now opens rendered, with proper headings, code blocks, and formatting — just like reading a web page.

Online options

If you don’t want to install anything, there are browser-based options:

• GitHub — If the .md file is in a GitHub repository, GitHub renders it automatically. Just navigate to the file on github.com.
• Markdown Live Preview (markdownlivepreview.com) — Paste your Markdown text and see it rendered side-by-side. Useful for quick checks.
• StackEdit (stackedit.io) — A more full-featured online Markdown editor and viewer.

The trade-off with online tools is that you have to either upload your file or copy-paste the contents into a browser. For a file someone emailed you, that means extra steps. For sensitive documents — meeting notes, internal specs, contract details — pasting content into a third-party website may not be ideal.

The simplest long-term solution

Here’s the honest answer to “how do I open .md files”: install a lightweight viewer, set it as your default handler for .md files, and never think about it again.

That’s really it. The reason .md files feel confusing is that operating systems don’t ship with a Markdown renderer. Once you add one, the problem disappears permanently. Every .md file opens like a web page — formatted, readable, and instant.

You don’t need a heavy editor. You don’t need a browser extension. You don’t need to convert files to PDF first. A small, native viewer that registers itself as the default app for .md files is the cleanest path. If you want to compare tools first, see all options in our 2026 roundup.

Markdown isn’t going away. If anything, it’s accelerating — AI tools generate it, developers write in it, and more teams are adopting it for documentation. Spending two minutes setting up a default viewer saves you from squinting at raw formatting symbols for the rest of your career.