Windows can open an .md file as plain text, but it does not include a built-in Markdown reading experience. Double-clicking the file may launch Notepad, Visual Studio Code, another associated application, or a dialog asking which program to use. All of those outcomes are normal. The useful question is whether you want to edit the Markdown source or read the rendered document.
For a quick formatted view, open the file in mdview.io. For repeated local work, use a Windows Markdown application or an editor with preview support.
Opening an .md file directly in a browser tab usually shows raw text or downloads the file again. A Markdown viewer performs the rendering step that the browser does not provide by itself.
| Option | Best for | Tradeoff |
|---|---|---|
| Browser viewer | Opening an occasional file without setup | Requires opening the viewer page |
| Desktop Markdown viewer | Frequent local reading and folder navigation | Requires installation |
| VS Code preview | Editing documentation in a project | More interface than a reader needs |
| Notepad | Inspecting or making a tiny source edit | No rendered formatting |
| GitHub | Reading a file already in a repository | Not suited to arbitrary local files |
A viewer should be judged against the documents you actually receive. A basic preview may handle headings and bold text but leave Mermaid diagrams as code, squeeze wide tables, or omit mathematical notation.
Use an online viewer when you need to inspect a file immediately, cannot install software, or are working on a temporary machine. Use a desktop viewer when local folder navigation, offline access, or opening many Markdown files is part of your daily workflow.
The alpha mdview desktop application focuses on that local workflow: open a file or folder, move between neighboring Markdown files, navigate with a table of contents, and render Mermaid diagrams without a server-side document pipeline. The browser version remains the quickest option when you only have one file to read.
Modern .md files can contain much more than prose:
Test a viewer with a real document rather than a two-line sample. The difference becomes obvious when a file includes a wide deployment table, nested code fences, or a large Mermaid diagram.
Opening a file locally for rendering is different from publishing it. If the document contains credentials, customer data, or internal architecture details, do not create a public share link. Review the viewer's behavior and use a local or offline workflow when policy requires the document to stay on the machine.
Relative images also need attention. A reference such as ./images/system.png depends on the file's surrounding folder. A desktop viewer with folder access can resolve that context more naturally than a single-file browser picker.
Notepad and VS Code can open the source. A Markdown viewer displays the formatted result. Choose based on whether you need to edit or read.
Windows can show the text, but it does not provide a full built-in renderer for Markdown tables, Mermaid diagrams, math, and other technical features.
Yes. Open the local file in mdview.io through Edge, Chrome, or Firefox.
.md to .txt?No. Markdown is already plain text. Changing the extension removes useful information without adding formatting.