How to Open an MD File in Windows

The fastest way to open an MD file in Windows is to right-click the file, choose Open with, and select a Markdown viewer or editor. Use Hashdraft when you want a complete formatted preview and the ability to edit the source. Use Notepad for a quick lightweight view or source edit.

What is an MD file?

An MD file is a plain-text document written in Markdown. Its extension is usually .md, although .markdown is also used. The text may contain punctuation such as # for headings, ** for bold text, and []() for links.

# Project notes

Read the **setup guide** before continuing.

- Install the app
- Open `README.md`
- Check the preview

A text editor displays those characters. A Markdown renderer interprets them and shows a formatted heading, paragraph, list, and inline code. The underlying file remains the same in both cases.

Method 1: Open the MD file in Hashdraft

A dedicated Markdown app is the clearest option for documents with tables, images, task lists, code blocks, footnotes, or math. Hashdraft is a free, open-source reader and editor built for local Windows files.

1. Download and install Hashdraft. The installer runs per user and does not require administrator rights.
2. Find the file in File Explorer. Look for a name such as README.md, notes.md, or guide.markdown.
3. Right-click and choose Open with. Select Hashdraft from the available applications.
4. Choose a view. Use Preview for reading, Edit for raw Markdown, or Split to see source and output side by side.

You can also launch Hashdraft and use Open, or drag the file into the window. Local image paths and links are resolved relative to the document, so keeping the file with its project folder usually produces the most accurate preview.

Method 2: Open the file in Notepad

Current Windows 11 Notepad releases support lightweight Markdown formatting. Depending on the installed app version and feature rollout, you can switch between formatted Markdown and syntax views. Notepad handles headings, bold and italic text, links, and simple lists, so it works well for quick inspection and small edits.

Notepad is not a complete Markdown publishing preview. Complex tables, syntax-highlighted code, local images, footnotes, math, and product-specific extensions may render differently or remain as source. Use a dedicated Markdown renderer when the final document must match its destination.

Method 3: Open the file in Visual Studio Code

VS Code is a good choice when the Markdown belongs to a software project. Open the containing folder, select the file, and use the built-in Markdown Preview command. You gain project search, Git tools, path completion, link validation, and access to source code in the same workspace.

For a single note or report, however, a full development environment can feel heavier than necessary. See the Markdown editor comparison for a workflow-based breakdown.

Method 4: Use an online Markdown viewer

An online viewer can render Markdown without installing an app. Paste the source or upload the document, then read the preview in a browser. This is convenient on a managed computer where software installation is blocked.

Do not upload confidential notes, credentials, customer data, unpublished work, or private repository files unless you trust the service and understand how it handles uploads.

Online viewers may also fail to display local images because the browser does not have access to the surrounding project folder. A local viewer avoids that problem.

Make Hashdraft the default app for MD files

If you open Markdown frequently, associate .md with one application so a double-click opens the correct view.

1. Open Settings in Windows.
2. Go to Apps → Default apps.
3. Search for the .md file type.
4. Select the current app and choose Hashdraft or another installed Markdown editor.

You can also right-click an MD file, choose Open with → Choose another app, select your preferred application, and use the option to make it the default when Windows offers it. Changing the association does not modify the document.

Why an MD file may not open correctly

The file opens as raw symbols

You opened it in a text editor rather than a renderer. Nothing is broken. Open the same file in Preview mode to see formatted headings, lists, and links.

Windows shows the wrong icon or app

The .md association points to another program. Change the default app by file type in Windows Settings.

The file is really named notes.md.txt

File Explorer may hide known extensions. Enable filename extensions in Explorer, then confirm the actual suffix. Renaming a file does not convert its contents, so only remove .txt if the file already contains valid Markdown text.

Images are missing

The image path may be relative to a folder you did not copy. Keep the MD file and its assets together, and read the Markdown images guide for correct paths.

The text contains replacement characters

The document may not be valid UTF-8. Hashdraft reports invalid text rather than silently changing it. Reopen the source in an editor that can identify its encoding, then save a UTF-8 copy.

The document is slow to render

Large images, huge tables, extremely long lines, and multi-megabyte documents can slow the first preview. See how to edit large Markdown files without lag.

Are MD files safe?

Markdown source is text, not an executable program. Still, a document can contain external links, remote images, or raw HTML. Treat files from unknown sources as untrusted, avoid following suspicious links, and use a viewer with conservative HTML handling. Hashdraft never executes scripts embedded in HTML.

Frequently asked questions