How to Open an .md File: 5 Easy Ways
You downloaded an .md file, double-clicked it and got "How do you want to open this file?" — or you opened it in Notepad and saw a mess of # and * symbols. That's a Markdown file, and with the right tool it turns into a neatly formatted document.
The fastest way: open the Moread online MD viewer and drag the file into the window. No install, no sign-up, and the file is never uploaded.
What is an .md file?
An .md (or .markdown) file is a plain-text document written in Markdown. Authors mark formatting with simple symbols: # for headings, **text** for bold, - for lists.
You'll find MD files everywhere:
README.mdfiles in GitHub projects- Installation guides and changelogs (
CHANGELOG.md) - Notes exported from Obsidian, Notion, HackMD or Typora
- Reports and documents generated by AI tools such as ChatGPT or Claude
Because it's plain text, any text editor can open it, but only a Markdown viewer turns the symbols into headings, tables and diagrams.
Method 1: Open it online (no install, recommended)
Best when you just want to read the file right now, on a computer or a phone.
- Go to Moread.
- Click Open file and pick your
.mdfile, or drag it onto the page. - The document appears fully formatted, with an automatic outline on the right.
Why Moread:
- Nothing is uploaded – the file is read inside your browser and cleared when you close the tab, so it's safe for work documents and private notes.
- Rich content support – tables, syntax highlighting, Mermaid diagrams and LaTeX math.
- Whole folders – use Open folder so relative links and local images work too.
- Export to PDF – click Print / save as PDF in the toolbar.
- Only have some text? Press
Ctrl + Von the home page to paste it, or use the online Markdown editor with live preview.
Pro tip: install it as an app and double-click .md files
In Chrome or Edge, an Install app button appears in Moread's title bar (or an install icon in the address bar). Once installed:
- Moread opens like a regular program from the Start menu or Dock, even offline.
- Right-click an
.mdfile → Open with → Moread, and set it as the default so a double-click opens the file directly.
Method 2: Open MD files on Windows
- Notepad: right-click the file → Open with → Notepad. You'll see the raw text, without formatting.
- Visual Studio Code: open the file and press
Ctrl + Shift + Vfor a preview. - Always open .md with a specific app: right-click → Properties → Change next to "Opens with".
Method 3: Open MD files on Mac
- TextEdit: right-click → Open With → TextEdit to see the raw text.
- Visual Studio Code: open the file and press
Cmd + Shift + Vto preview. - Typora or Obsidian: dedicated Markdown apps, good for regular writing.
If you only need to read a file now and then, opening Moread in your browser is the simplest option.
Method 4: Open MD files on iPhone and Android
Built-in phone apps usually show only raw text. The easy fix:
- Open Moread in Safari or Chrome.
- Tap Open your first file and choose the
.mdfile from Files or Downloads. - The layout switches to a phone-friendly single column automatically.
Method 5: View it on GitHub or in a code editor
- If the file is on GitHub, just click it – GitHub renders Markdown automatically.
- Developer editors like VS Code and JetBrains IDEs include a built-in Markdown preview.
Common questions
The text looks garbled. What should I do?
That's usually a text-encoding mismatch. Moread detects UTF-8, UTF-16 and older Windows-1252 files automatically, so most files display correctly. In Notepad, you can use Save as and choose UTF-8.
Why don't the images show up?
An MD file only stores the path to each image; the images are separate files. Use Open folder to open the whole folder, and Moread will find the images next to the document.
Can I convert an MD file to PDF or Word?
For PDF, open the file in Moread, click Print / save as PDF and choose Save as PDF in the print dialog. Diagrams and formulas are preserved. For Word, save as PDF first and open that PDF in Word to convert it.
Can I edit an MD file?
Yes. Click the pencil icon in the toolbar to switch to a side-by-side editor with live preview, then press Ctrl + S to download the updated .md file. To learn the syntax, see the Markdown syntax guide.
Next time you get an .md file, open md-viewer.amemori.win and drop it in.