How to Open a Markdown File on Any Device

Here's how to open a markdown file: double-click it and any text editor shows the contents, because .md is plain text. To see it formatted, with real headings and bold, you need a renderer such as VS Code, a browser extension, or an online editor. This guide gives the fastest route on each device.

What Program Opens a Markdown File?

Two kinds of program open Markdown, and picking the wrong kind is why the file "looks broken". A text editor (Notepad, TextEdit, nano) opens the raw symbols: # Heading, **bold**, - item. A renderer reads those symbols and draws the formatting. Every device already has the first kind; the second kind is what most searches for how to open md files are really after.

Here's the same file both ways. In a text editor you see this:

# Release notes

- Fixed the **login** bug
- See [the changelog](https://example.com)

In a renderer you see a large "Release notes" heading, a two-item bullet list with "login" in bold, and a clickable link. Nothing about the file changed; only the program did. If you want the format explained before the mechanics, read our plain-English explanation of Markdown.

The best way to view markdown files depends on how often you do it. Once, from an email attachment: paste it into a browser editor. Daily, as a developer: use your code editor's preview. Both are below.

How to Open MD Files on Windows

Windows ships no Markdown renderer, but it ships two ways to read the text.

1. Right-click the file, choose Open with, then Notepad. The raw text appears immediately.
2. For formatting, install VS Code, open the file, and press Ctrl+Shift+V to switch to the rendered preview. Ctrl+K V puts the preview beside the source, per the VS Code Markdown docs.

Since the Text Formatting update to Notepad (version 11.2504.50.0, announced May 2025), Windows 11 Notepad also has a View > Markdown toggle between Syntax and Formatted. The announcement lists headings, bold, italic, lists, and links. Tables and fenced code blocks are not on that list, so treat it as a quick look rather than a full viewer. For the full picture on this platform, our Windows Markdown viewer roundup compares the options.

How to Open an MD File on a Mac

Double-clicking a .md file on a Mac usually launches Xcode if you have it installed, or TextEdit if you don't. Both show the raw text. Xcode takes several seconds to start, which is the most common complaint about opening markdown files on macOS.

Here's how to view a markdown file rendered instead:

1. Install VS Code, then drag the file onto its Dock icon. Press Shift+Cmd+V for the preview, or Cmd+K V for side by side.
2. Or select the file in Finder, press the space bar for Quick Look, and read the raw text. Quick Look shows plain text unless you install a Markdown Quick Look extension.

We prefer the VS Code route on a Mac because the preview follows CommonMark and renders Mermaid diagrams and KaTeX math without extensions, which the docs confirm. The Mac viewer guide covers Quick Look plugins and lighter apps.

How to Open Markdown Files on Linux, iPhone, and Android

On Linux, any editor works for the text: nano notes.md, gedit notes.md, or vim notes.md. For formatting in the terminal itself, install glow (brew install glow on Homebrew, sudo apt install glow after adding the Charm repository, or winget install charmbracelet.glow on Windows). Then run:

glow README.md
glow -p README.md

The first command renders the file with styled headings and lists in the terminal. The -p flag pages long files through less. If you only need to read a short file, cat notes.md or less notes.md prints the raw text with no install at all, and that's often enough for a changelog or a config note. VS Code's preview shortcuts on Linux match Windows: Ctrl+Shift+V and Ctrl+K V.

On an iPhone, tap the file in the Files app and Quick Look displays it as plain text. It doesn't render the symbols. For a rendered view, open the file in a browser-based editor (next section) or install Obsidian, which reads .md files from a folder on iOS and Android.

Android has no built-in handler for .md either, so the first tap asks you to choose an app. Any text editor app shows the raw text; Obsidian or a browser editor shows it formatted.

How Can I View Markdown Files in Chrome?

A browser is the zero-install answer for how to open an md file with formatting, on every platform including phones and locked-down work laptops. If you've been searching how to view markdown files without installing anything, this is the section. There are two routes.

Route 1: paste into an online editor. Open the file in any text editor, select all, copy, and paste into our editor. The right-hand pane renders it as you paste, and the preview is built in your browser.

The demo below is pre-filled with a sample file so you can see what a rendered .md looks like before you try your own.

Route 2: open local files in Chrome directly. Install the open-source Markdown Viewer extension (available for Chrome, Firefox, Edge, Brave, and others). Then go to chrome://extensions, click Details on the extension, and switch on Allow access to file URLs. Without that switch, dragging a .md file into Chrome shows raw text. With it, the file renders, and the extension reloads it when the file changes on disk. Our Chrome extension walkthrough has the full setup.

Set the Default App So Double-Click Just Works

Once you've picked a renderer, make it the default so you never see the Xcode splash screen or a Notepad window again.

Windows 11. Right-click any .md file, choose Open with > Choose another app, pick the app, and click Always. That menu is quicker than Settings > Apps > Default apps, which may offer a Store search before it lists installed apps. If you do use Settings, type .md in the search box and choose the app from the list.

macOS. Select the file in Finder, press Cmd+I for Get Info, expand Open with, choose the app, then click Change All. Apple's guide to choosing an app to open a file warns that Change All applies to every file of that type, which is exactly what you want here.

VS Code as a viewer. If you'd rather see the preview than the source when a file opens, add this to your settings JSON:

"workbench.editorAssociations": {
  "*.md": "vscode.markdown.preview.editor"
}

Every .md file then opens straight into the rendered view. When you want to write as well as read, our comparison of Markdown editors lists the ones with the best previews.

Common Markdown File Opening Mistakes

Opening it in Word and expecting formatting. Word treats a .md file as plain text: pick All Files in the Open dialog and you get the raw symbols, plus an encoding prompt. It has no Markdown mode of its own. If you need a real Word document, convert it first with the Markdown to DOCX tool, or read how to convert Markdown to Word.

Renaming the file to .txt. That opens it, but you lose the association that tells renderers and Git tooling it's Markdown. Set the default app instead.

Dragging a file into Chrome without file access. The Markdown Viewer extension can't read file:// URLs until you flip the Allow access to file URLs switch. The page looks like the extension isn't installed at all; it is, it just can't see the file.

Opening Markdown Files FAQ

That's how to open a markdown file wherever you are. A text editor shows the raw symbols, a renderer shows the formatting, and the default-app setting decides which one you get on double-click. When you're on a phone or a machine you can't install software on, paste the file into the editor and read it rendered right away.