What Is a .md File? How to Open Markdown Files

A .md file is a plain text document written in Markdown — a lightweight formatting language that uses simple symbols like # and ** to mark headings, bold text, and lists. The .md extension is short for “Markdown”. You can open one in any text editor, but you need a Markdown viewer to see it rendered with real formatting instead of raw symbols.

That’s the short answer. Below: what the format is for, why .md files suddenly appear everywhere, how the extension relates to .txt and .markdown, and the fastest way to open one on each platform.

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.

The .md file extension, precisely

The .md file format is not a proprietary format — there is nothing to buy, unlock, or convert. A few specifics people usually want:

All those extensions mean the same thing. .md won because it’s short; .markdown is the original long form. If you get a file ending in .mdown or .mkd, treat it exactly like a .md file — rename the extension if a program refuses to open it.

.md vs .txt — what’s the difference?

Both are plain text, and both open in any editor. The difference is intent:

• A .txt file is text and nothing more. There’s no convention for what a # means.
• A .md file is text plus an agreed set of formatting conventions. # Heading is understood by every Markdown tool to mean a heading, so the file can be rendered into formatted output.

Rename a .md file to .txt and you lose nothing — the content is identical. You just lose the signal that tells software how to render it. That’s why .md exists as a separate extension at all.

How to create a .md file

Make a new text file, write your content, and save it with a .md extension instead of .txt. That’s genuinely all there is to it — on Mac, TextEdit needs to be in plain-text mode first (Format → Make Plain Text); on Windows, choose “All Files” in Notepad’s save dialog so it doesn’t append .txt.

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 — what you get by double-clicking. Shows the raw source: pound signs, asterisks and all. Readable, not pleasant.
• Quick Look (Space in Finder) — also raw text. The QLMarkdown plugin fixes it, but needs Homebrew and permissions setup.
• VS Code — renders well with Cmd+Shift+V, but it’s a 400MB IDE. The right tool for writing code, not for reading a README.
• MDHero — a native Markdown viewer under 8MB. Double-click, see rendered output instantly, with syntax highlighting, math, diagrams and dark mode.

Whichever you pick, the step that actually solves the problem is making it the default app: right-click any .md file in Finder → Get Info → expand Open with → select your viewer → Change All. Every .md file opens rendered from then on.

📖 Full walkthrough: Markdown viewer for Mac — the complete guide, or the Mac setup page.

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 — the default. Raw text, no rendering. Fine for a glance.
• VS Code — renders with Ctrl+Shift+V. Convenient if it’s already open; overkill if it isn’t.
• MDHero — a free .md file opener for Windows 10 and 11, under 8MB, rendering on double-click.

Then set your viewer as the default handler:

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

Every .md file now opens rendered — headings, code blocks and all — like reading a web page.

📖 Full walkthrough: How to open .md files on Windows, or the Windows setup 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.