How to Open MD Files on Mac, Windows & Linux (2026)

TL;DR: An MD file is plain text — any text editor opens it. For a rendered preview with styled headings, tables, and code blocks, use VS Code (Ctrl+Shift+V), a native viewer like MacMD on macOS, or an online Markdown preview tool. This guide covers 5 methods across macOS, Windows, Linux, and the browser.

You downloaded a repository, received a README from a colleague, or found a .md file in a project folder — and now you need to open it. The good news: every operating system can open an MD file because it is plain text. The real question is whether you want to see raw syntax characters or a properly rendered document with styled headings, clickable links, and formatted code blocks.

GitHub hosts over 630 million repositories (GitHub Octoverse, 2025), and nearly every one contains at least one .md file. If you work with code, documentation, or technical writing, knowing how to open MD files quickly — and with the right tool — saves time every single day.

630 million repositories on GitHub contain .md files for READMEs, changelogs, and documentation (GitHub Octoverse, 2025). Learning how to open an MD file correctly is a foundational skill for anyone working with modern software projects.

What Is an MD File and Why Does It Need a Specific Opener?

An MD file is a plain-text document written in Markdown, the lightweight markup language created by John Gruber in 2004. The .md extension tells your system the file contains formatting syntax — characters like # for headings, ** for bold, and - for lists — that a renderer converts into styled HTML.

The CommonMark specification (version 0.31.2, January 2024) standardizes this syntax across more than 600 test cases. Any tool that follows CommonMark renders the same .md file identically, which is why Markdown became the default format for technical documentation.

Here is the catch: opening an MD file in Notepad or TextEdit shows the raw syntax, not the formatted output. You see ## Heading instead of a styled heading and [link](url) instead of a clickable hyperlink. That raw view is useful for editing, but when you need to read or review a Markdown document, you need a tool that renders it. For a deeper explanation of the format itself, see the guide to MD files.

The .md extension stands for Markdown, a plain-text formatting syntax standardized by the CommonMark specification (version 0.31.2, 2024). Unlike binary formats like .docx, an MD file is readable in any text editor — but a dedicated viewer renders headings, tables, and code blocks as styled HTML.

How Do You Open an MD File on macOS?

macOS offers several ways to open MD files, from built-in tools to dedicated viewers. The right choice depends on whether you need to edit the file or simply read it.

Method 1: TextEdit (built-in, raw view)

TextEdit ships with every Mac. It opens .md files but shows raw Markdown syntax without rendering.

1. Right-click the .md file in Finder.
2. Select Open With and choose TextEdit.
3. If the file appears with formatting artifacts, go to Format > Make Plain Text (Shift+Cmd+T).

This works for quick edits but is not ideal for reading documentation. You see **bold** as literal characters, not styled text.

Method 2: Terminal commands (raw view)

For a fast glance at a file's contents without opening an editor:

cat README.md          # Print the entire file
less README.md         # Scroll through page by page
head -n 30 README.md   # Show the first 30 lines

Terminal output is plain text — no rendering. But when I need to check a README before cloning a full project, less is the fastest option because I am already in the terminal.

Method 3: MacMD Viewer (native rendered view)

A dedicated Markdown viewer renders the file as styled HTML with headings, tables, syntax-highlighted code blocks, and Mermaid diagrams. MacMD Viewer is built specifically for this workflow on macOS:

1. Open MacMD Viewer or double-click any .md file (once MacMD is set as the default handler).
2. The file renders instantly with a clickable table of contents sidebar.
3. Edit the file in your preferred editor — MacMD watches for changes and refreshes the preview automatically.

MacMD also adds QuickLook integration, which means you can press Space on any .md file in Finder to see a rendered preview without opening any application. That single feature eliminates the most common friction point: double-clicking an MD file and getting dumped into Xcode or a raw text editor.

On macOS, double-clicking a .md file typically opens Xcode or TextEdit — neither renders Markdown formatting. A dedicated viewer like MacMD Viewer registers as an MD file handler and adds QuickLook support, so pressing Space in Finder shows a fully rendered preview instantly.

How Do You Open an MD File on Windows?

Windows does not recognize .md files natively, but several methods let you open and view them.

Method 1: Notepad (built-in, raw view)

1. Right-click the .md file in File Explorer.
2. Select Open with and choose Notepad.
3. The file opens as plain text showing raw Markdown syntax.

Notepad works for quick edits but cannot render Markdown. For files with tables, code blocks, or diagrams, the raw view is difficult to follow.

Method 2: VS Code (free, rendered preview)

Visual Studio Code is the most popular code editor — used by 73% of developers according to the Stack Overflow Developer Survey, 2024 — and it has built-in Markdown support.

1. Open VS Code and drag the .md file into the window, or use File > Open File.
2. Press Ctrl+Shift+V to open a rendered preview in a new tab.
3. Press Ctrl+K V to open a side-by-side view with source on the left and preview on the right.

VS Code renders headings, bold, italic, links, images, lists, and code blocks. For extended syntax like Mermaid diagrams or LaTeX math, install the Markdown Preview Enhanced extension.

Method 3: Browser-based viewer (no install)

If you cannot install software, paste the file contents into an online Markdown preview tool to see the rendered output immediately. No account or download required.

VS Code is used by 73% of developers (Stack Overflow Developer Survey, 2024) and includes built-in Markdown preview. Press Ctrl+Shift+V on Windows to render any .md file instantly.

How Do You Open an MD File on Linux?

Linux distributions ship with multiple tools capable of opening MD files, both in the terminal and in graphical environments.

Terminal-based viewing

Most Linux systems have cat, less, or bat pre-installed or easily available:

cat README.md            # Full file dump
less README.md           # Paginated scrolling
bat README.md            # Syntax-highlighted output (install via package manager)

The bat command is particularly useful — it applies syntax highlighting to the raw Markdown, making headings and code fences visually distinct even without full rendering.

GUI text editors

• gedit (GNOME) — opens .md files as plain text with syntax highlighting.
• Kate (KDE) — includes a Markdown preview plugin that renders the file alongside the source.
• Mousepad (Xfce) — lightweight editor for raw Markdown viewing.

VS Code on Linux

The same VS Code workflow applies on Linux. Install VS Code via your distribution's package manager or Snap store, open the .md file, and press Ctrl+Shift+V for the rendered preview.

Dedicated terminal renderers

Tools like glow render Markdown directly in the terminal with styled output:

glow README.md    # Renders Markdown with colors and formatting in the terminal

glow is open source (charmbracelet/glow on GitHub) and available via Homebrew, Snap, and most Linux package managers.

Linux users who open MD files frequently in the terminal should try glow or bat before installing a GUI tool. Both render Markdown with visual structure — bat adds syntax highlighting to the raw source, while glow produces fully styled output with colors, line wrapping, and heading hierarchy (charmbracelet/glow, GitHub).

How Do You Open an MD File in a Web Browser?

You do not always need to install software. Two browser-based approaches work on any operating system.

Drag and drop into the browser

Some browsers display .md files as raw text when you drag them into a browser window. This is functionally identical to opening them in Notepad — you see the source, not the rendered output.

Use an online Markdown viewer

Online tools parse your Markdown and render it as styled HTML in real time. The MacMD Markdown Preview tool lets you paste or type Markdown content and see the formatted result instantly. Other options include StackEdit and Dillinger.

This approach is ideal for:

• Previewing a single file without installing anything.
• Viewing Markdown on a shared or locked-down machine.
• Quickly checking formatting before committing a README.

For viewing Markdown files regularly, a desktop viewer is faster and works offline. But for occasional use, a browser tool gets the job done. See the full comparison of online markdown viewers for more options.

Browser-based Markdown viewers require no installation and work on any operating system. They parse Markdown syntax client-side and render styled HTML in real time. The trade-off is that local file watching and offline access are unavailable — for daily use, a desktop viewer is more efficient.

Which Method Should You Choose to Open an MD File?

Use VS Code if you already have it installed — it covers editing and previewing in one tool. On macOS, a dedicated viewer like MacMD is faster for read-only workflows because it renders files on double-click and adds QuickLook. For one-off checks, an online preview tool is the lowest-friction option. The full comparison:

If you open MD files more than a few times per week on a Mac, a dedicated viewer pays for itself immediately. The difference between reading raw ## Heading syntax and seeing a properly styled document with a sidebar table of contents is the difference between deciphering code and reading a document.

FAQ

Can I open an MD file on my phone?

Yes. On iOS, apps like Working Copy (Git client with Markdown preview) and iA Writer render MD files. On Android, Markor is a free, open-source Markdown editor and viewer. You can also paste Markdown content into any browser-based preview tool from your phone.

Why does my MD file open in Xcode on Mac?

macOS associates .md files with Xcode if it is installed, because Xcode registers itself as a handler for Markdown files. To change this: right-click any .md file in Finder, select Get Info, change the Open with dropdown to your preferred app (such as MacMD Viewer), and click Change All to apply it to all .md files.

Is an MD file the same as a TXT file?

Both are plain text, but an MD file contains Markdown formatting syntax that a renderer can convert to HTML. A .txt file has no formatting standard — it is raw text. Renaming a .md file to .txt does not change its content, but text editors will not apply Markdown syntax highlighting. For a detailed comparison, see what is a Markdown file.

Do I need internet access to open an MD file?

No. An MD file is a local plain-text document. Any text editor opens it offline. Desktop viewers like MacMD Viewer and VS Code also work entirely offline. Only browser-based online viewers require an internet connection.

What is the difference between viewing and editing an MD file?

A viewer renders the Markdown as formatted HTML — read-only, no changes to the file. An editor lets you modify the content and often includes a live preview pane. If you only need to read documentation, a dedicated MD file viewer is cleaner and faster than opening a full editor.