How to Open .md Files on Windows Without the Clutter

You downloaded a file. Maybe a README from GitHub, maybe a project spec from a coworker, maybe a Claude or ChatGPT response you saved. The extension is .md. You double-click it.

Windows stares back at you. “How do you want to open this file?”

You pick Notepad. Now you’re looking at raw text littered with # symbols, asterisks, backtick fences, and [link](url) syntax. None of it is rendered. It’s like reading HTML source instead of a web page.

This is the default experience for markdown on Windows, and it hasn’t changed in over a decade. Windows has no built-in markdown renderer or markdown reader. It doesn’t even recognize .md as a known file type out of the box. If you’ve searched for “open md file Windows” or “how to open .md files” — or you need a markdown viewer for Windows that just works — here’s how to fix that, from quick hacks to the proper setup. (New to Markdown? Start with what is a .md file.)

Why .md files are suddenly everywhere

Markdown used to live in developer land — READMEs, changelogs, and the occasional blog post. That changed. Now it’s the default output format for ChatGPT, Claude, Gemini, and every LLM tool on the market. It’s how Obsidian stores notes, how Notion exports pages, how Substack drafts work, and how every open-source project documents itself.

If you work with text in 2026, you encounter .md files whether you chose to or not. Windows just never caught up.

Option 1 · Notepad and Notepad++

What happens: You see the raw markdown source. Headings are lines starting with #. Bold text is wrapped in **. Links show the full [text](url) syntax. Code blocks are indented or fenced with triple backticks.

Notepad gives you plain text in a monospace font with zero syntax awareness. Since the Windows 11 update, Notepad at least has tabs and a dark mode, but it still treats .md like any .txt file.

Notepad++ is better for editing. It recognizes markdown syntax and applies some color-coding — headings get one color, links another. But it still doesn’t render anything. You’re reading source, not output. No images, no tables, no formatted code blocks.

Verdict: Fine for quick edits. Terrible for reading. If someone sent you a project spec or a long README and you opened it in Notepad, you’d think markdown was a broken format.

Option 2 · VS Code

VS Code is the most common suggestion in every forum thread and Stack Overflow answer about opening .md files. And it works — open the file, press Ctrl+Shift+V, and you get a rendered preview panel. The rendering is GitHub-flavored, handles tables and code blocks well, and you can split the screen to see source and preview side by side.

The problem is everything else. VS Code is a full IDE. Installing it to read a markdown file is like installing Photoshop to view a JPEG. The download is 90MB, the installed size is north of 500MB once extensions load, and it takes several seconds to cold-start. You get a file explorer, a terminal, a source control panel, an extensions marketplace, and a status bar full of information you don’t need.

If VS Code is already your daily driver, the built-in preview is genuinely useful. If you don’t code, this is the wrong tool.

Verdict: Great rendering, absurd overhead. Use it if you already have it open. Don’t install it just for markdown.

Option 3 · Browser extensions

Here’s a trick that works in a pinch: drag a .md file directly into Chrome or Edge. By default you’ll see raw text — but install an extension like Markdown Viewer (Chrome Web Store) or Markdown Preview Plus, and the browser will render it with full styling.

Setup isn’t exactly seamless:

1. Install the extension from the Chrome Web Store.
2. Go to chrome://extensions, find the extension, and click Details.
3. Enable “Allow access to file URLs” — this is off by default, and without it the extension won’t touch local files.
4. Drag your .md file into a new tab.

It works. The rendering is decent. But it’s clunky in practice. You’re opening a browser tab every time you want to read a file, mixing documents with your web browsing, and relying on a third-party extension that may or may not get updated. There’s no way to set Chrome as the default handler for .md files in any clean way, so you’re always doing the drag-and-drop dance.

Verdict: Useful as a fallback. Not something you want to do twice a day.

Option 4 · Microsoft Store apps

Search “markdown viewer” in the Microsoft Store and you’ll find a handful of options — Markdown View, Markdown File Viewer, Markdown Editor, and others with nearly identical names and generic icons.

The reality is grim. Most of these apps were last updated in 2022 or earlier. Several are UWP apps that never made the transition to WinUI 3 and look out of place on Windows 11. Reviews mention crashes, broken rendering, and missing features like syntax highlighting or dark mode. A few are actually markdown editors that happen to show a preview pane, so half your screen is an editing toolbar you don’t want.

There are exceptions — a couple of Store apps are actively maintained and perfectly usable. But finding them requires sifting through abandoned software, and even the good ones tend to be Electron wrappers shipping 150MB+ for what should be a lightweight tool.

Verdict: Hit-or-miss. If you find a good one, great. But the Store doesn’t surface quality well in this category.

Option 5 · A native markdown viewer Windows users deserve (and an .md file viewer that just works)

Here’s what opening a .md file should feel like: double-click, rendered markdown appears, you read it, and if you need to fix a typo you press one shortcut and edit it in place. No IDE, no browser, no extension permissions. This is what a real markdown viewer Windows users can rely on looks like — and what an .md file viewer should have been all along.

MDHero is a native desktop markdown viewer and markdown reader Windows users can install in seconds, with a built-in lightweight editor (Ctrl+E to toggle, Ctrl+S to save), built with Tauri and Rust. The installer is ~8MB. It cold-starts in under a second. It renders GitHub-Flavored Markdown with:

• Syntax highlighting for 25+ languages
• KaTeX math rendering (inline and block)
• Mermaid diagrams (flowcharts, sequence diagrams, Gantt charts)
• GFM tables, task lists, and footnotes
• Tabs for opening multiple files at once
• Table of Contents sidebar for navigating long documents
• Dark mode that follows your Windows theme (or toggle manually)
• Built-in editor — flip into edit mode with Ctrl+E, save with Ctrl+S. The scroll position follows you between viewer and editor (added in v0.2.0)

You can set it as your default .md handler and forget about it. Every .md file you double-click from that point forward opens rendered and readable — and editable when you need it to be.

It’s free, open source (MIT), and doesn’t phone home. No account, no telemetry, no “upgrade to Pro” banners.

How to set a default .md handler on Windows

This works for MDHero or any other viewer you choose. The goal is simple: make double-click on a .md file open your viewer instead of Notepad.

On Windows 10

1. Find any .md file in File Explorer.
2. Right-click the file.
3. Hover over Open with and click Choose another app.
4. Select your viewer from the list (or click More apps, then Look for another app on this PC to browse to the .exe).
5. Check the box that says “Always use this app to open .md files”.
6. Click OK.

That’s it. Every .md file on your system now opens with your chosen viewer.

On Windows 11

Microsoft changed the default apps UI in Windows 11, and it’s noticeably harder to use.

The Settings path (always works):

1. Open Settings (Win+I).
2. Go to Apps → Default apps.
3. In the search bar at the top, type .md.
4. Click the current default (probably a generic icon or Notepad).
5. Select your viewer from the list or browse for it.
6. Click Set default.

The right-click path (may work on recent builds):

1. Right-click a .md file.
2. Click Open with → Choose another app.
3. Select your viewer.
4. Check “Always use this app to open .md files” if the checkbox appears.
5. Click OK.

Either way, once it’s set, you’re done. Double-click any .md file and it opens rendered.

Bonus: reading AI output on Windows

Here’s a scenario that’s becoming more common every week: you copy a long response from ChatGPT or Claude, paste it into a file, save it as response.md, and try to read it.

The problem is that AI chat interfaces often copy text with literal \n characters instead of real newlines. Paste into Notepad and you get a single long line peppered with backslash-n. Paste into a markdown viewer and most of them render it the same way — as literal text, not line breaks.

MDHero has an LLM paste mode that auto-detects this. When it sees text with escaped newlines, it unescapes them and renders clean markdown. You can also trigger it manually with Ctrl+Shift+V. No regex find-and-replace, no preprocessing scripts — just paste and read.

This is also useful for Claude Code plans. Claude Code writes planning files to ~/.claude/plans in markdown format. Point MDHero at that folder and you can flip through your recent plans like documents in a folder view. On Windows, that path is typically C:\Users\<you>\.claude\plans.

The verdict

Windows has no built-in markdown rendering and probably never will. That means you need a third-party tool, and the question is just how much overhead you’re willing to accept.

If you already live in VS Code, use its preview. If you want a zero-install option, the browser extension trick works. But if you open .md files regularly — READMEs, specs, AI output, notes — install a lightweight native viewer, set it as default, and stop thinking about it.

MDHero is free, 8MB, and open source. Download it for Windows and set it as your default in thirty seconds. Also available for Mac.

Looking for more options? See our best free markdown viewers comparison. If you also paste AI output frequently, check out how to fix ChatGPT paste formatting.