How to Open .md Files on Windows, Mac, and in a Browser

If you received a .md file and are not sure what opens it, the simplest answer is: a Markdown file is plain text, so you can open it with a normal text editor. You only need a Markdown viewer or editor when you want headings, tables, lists, and code blocks to render in a readable layout.

The three easiest ways to open a .md file

If your only goal is to check what the file says, a text editor is enough. If the Markdown symbols make it hard to read, switch to a viewer.

oka-project's Markdown Viewer is a free, no-sign-up browser tool for previewing .md files and Markdown text. The document is processed in the browser rather than uploaded to a conversion server, which makes it useful for quick one-off checks.

What is a .md file?

The .md extension is commonly used for Markdown documents.

Markdown is a plain-text format that uses simple characters to represent structure such as headings, lists, links, code, and tables. RFC 7763 registers text/markdown as the media type for Markdown.

A Markdown file might look like this when opened as plain text:

# Setup

To start this project:

1. Install the dependencies
2. Check the configuration
3. Run the app

A Markdown viewer turns # Setup into a heading and the numbered lines into a list.

So a .md file is not a special binary file that requires one specific application. It is text with lightweight formatting syntax.

Open a .md file on Windows

For a quick read, right-click the file and choose Open with, then select a text editor such as Notepad.

You will see the Markdown syntax directly:

# Heading

- Item A
- Item B

That is normal. The file is open correctly; it just has not been rendered.

If you want headings, tables, and code blocks to appear formatted, use a Markdown viewer or a Markdown-capable editor instead.

Open a .md file on Mac

On macOS, you can use Finder's Open With menu and choose a text editor that can read plain text.

As on Windows, the raw Markdown characters remain visible. That is fine if you only need the content.

For a formatted preview, use a Markdown viewer or editor.

Open a Markdown file in a browser

A browser-based viewer is useful when you want to inspect one file without installing a full editor.

With Markdown Viewer, the flow is:

1. Open the viewer.
2. Choose a .md file or paste Markdown text.
3. Read the formatted preview.

This is useful for README files, AI-generated drafts, notes, and technical documents that you only need to inspect occasionally.

For a broader comparison of browser preview methods, see How to Preview Markdown in a Browser.

Use an editor when you work with Markdown regularly

A viewer is designed for reading. If you write Markdown every day, manage several files, or use Git, a dedicated editor is usually a better fit.

VS Code and other Markdown-capable editors can provide:

• editing and preview side by side
• project navigation
• search across files
• Git integration
• extensions and shortcuts

The choice is less about which tool has the most features and more about whether you are reading one file or maintaining Markdown as part of your workflow.

"The file opens" and "the Markdown renders correctly" are different problems

Markdown is plain text, but Markdown implementations are not all identical.

Rendering can differ for features such as:

• tables
• task lists
• line breaks
• fenced code blocks
• inline HTML

GitHub, for example, uses GitHub Flavored Markdown (GFM). If a README will ultimately be published on GitHub, a local or browser preview is useful for an initial check, but GitHub itself should be the final reference for how it will render there.

Check where an online viewer processes your file

A tool running in a browser can still upload your document to a server, so "web-based" does not automatically mean "local processing."

If the file contains private or unpublished material, check how the tool handles it.

oka-project's Markdown Viewer processes the Markdown in the browser and is designed not to send or store the document body on a conversion server. Outbound connections are also restricted with Content Security Policy.

For the implementation details, see How Browser-Only Tools Can Enforce "No Upload". For a broader file-safety checklist, see Files You Should Not Upload to Online Tools.

If a .md file still does not look right

First, separate two different problems.

The text itself is unreadable

If the file displays garbled characters, the issue may be text encoding or the way the file was created.

The text is readable, but Markdown symbols are visible

If you can read lines such as:

# Heading
| Column A | Column B |

then the file is already open. You simply need a Markdown renderer if you want the formatted version.

This distinction usually tells you whether you need another text editor or just a Markdown viewer.

A simple rule

For most people, these three choices are enough:

1. I only need the text → use a normal text editor.
2. I want to read formatted Markdown → use a Markdown viewer.
3. I edit Markdown regularly → use a Markdown-capable editor such as VS Code.

You do not need to install a large Markdown application just to inspect one file.

If you only need to open a .md file once, Markdown Viewer can preview it directly in the browser.

References

• RFC 7763: The text/markdown Media Type
• GitHub Flavored Markdown Spec
• GitHub Docs: Basic writing and formatting syntax