Windows can open an .md file in several ways. Recent Windows 11 Notepad versions can switch between Markdown syntax and formatted text, while older versions may show only the source. Double-clicking the file may launch Notepad, Visual Studio Code, another associated application, or a dialog asking which program to use. The useful question is whether you want a quick edit or a reader for the whole technical 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 |
| Recent Windows 11 Notepad | Light editing and basic Markdown formatting | Check its version and support for diagrams and other technical features |
| 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 mdview Desktop beta 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 on your computer. The browser version remains the quickest option when you only have one file to read.
If opening local Markdown is part of your daily work, download mdview Desktop for Windows 11. The desktop page lists the current beta's features and system requirements. Use the browser viewer when you need to read a file without installing an app.
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, VS Code, and Markdown viewers can open .md files. Recent Windows 11 Notepad can also display basic formatted Markdown. Choose a dedicated viewer when you need features such as Mermaid diagrams, folder browsing, or a reading-focused layout.
Recent Windows 11 Notepad versions support switching between Markdown syntax and formatted text. That does not make every technical Markdown feature available: check a real document with tables, Mermaid diagrams, or math before choosing a viewer. Microsoft's Notepad announcement explains the formatting feature.
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.
After installing a reader, Windows may still open .md files in the previous editor. Change the file-type association separately from choosing or downloading an application. Follow the Windows 11 default Markdown app walkthrough to set the association and test it with a small file.
Keep your editor available through Open with if you want to modify source. Selecting a reader as the default changes the opening behavior, not the content or ownership of your files.