How to Open an .md File on Windows, Mac, iPhone & Android
Someone sent you a file ending in .md, or you downloaded a README, and your computer doesn’t know what to do with it. Here’s what the file is, the fastest way to read it anywhere, and the exact steps for every major platform — including the new built-in Markdown support in Google Docs, OneDrive, Apple Notes, and Windows Notepad.
An .md file is a plain-text Markdown document. Any text editor opens it, but you’ll see symbols like # and **. To read it formatted on any computer or phone, open MarkdownPreview.net and drag the file in (or tap Open File) — nothing is uploaded and nothing needs installing.
What is an .md file?
.md (or .markdown) is the extension for Markdown, a family of plain-text formatting syntaxes officially registered as the text/markdown media type (RFC 7763). You write # Title for a heading, **bold** for bold, - item for a list, and a Markdown viewer turns it into a formatted page. It’s used for README files on GitHub, documentation, notes apps like Obsidian, and the text that AI assistants produce.
Because it’s plain text, an .md file is safe to open in any text editor and won’t break if the formatting isn’t rendered — it just looks less tidy. New to Markdown? Read what Markdown is; our Markdown syntax at a glance covers the essentials, and MDConverter’s Markdown cheat sheet covers everything else.
Any device: open it in your browser
Works the same on Windows, Mac, Linux, ChromeOS, iPhone, iPad, and Android.
- 1Open MarkdownPreview.net.
- 2Drag the .md file onto the editor, or click Open File and choose it (on a phone, pick it from Files or your file manager).
- 3Read it in the preview. Use Read for a full-width view and Outline to jump between sections.
- 4Optional: Export it as PDF or HTML, or Copy Rich Text to paste into Word or Google Docs.
The file is read by your browser and never uploaded. For more browser-based options, see 6 ways to preview Markdown in a browser.
Windows 10 & 11
Open it once
- 1Right-click the file and choose Open with → Choose another app.
- 2Pick Notepad (plain text), VS Code, or another Markdown app.
Always open .md files with the same app
- 1Open Settings → Apps → Default apps.
- 2Type
.mdin the search box under file types and select it. - 3Choose the app you want. Repeat for
.markdownif you use it.
See it formatted
- Notepad (Windows 11): Microsoft has been adding Markdown formatting to Notepad — headings, bold and italic, links, lists, and later tables and strikethrough — with a toggle between the formatted view and the raw Markdown (View menu or status bar). It has rolled out through Windows Insider channels since May 2025, so it may not be on every PC yet; update Notepad from the Microsoft Store to get the latest version.
- Preview pane (Microsoft PowerToys): install PowerToys, turn on its File Explorer add-on for Markdown, then enable View → Preview pane in File Explorer to see .md files rendered when you select them. PowerToys Peek also previews Markdown — select a file and press Peek’s activation shortcut (Space by default in recent versions; check PowerToys Settings → Peek).
- VS Code: open the file and press Ctrl+Shift+V — see our VS Code guide.
Mac
Open it once
- 1Control-click the file and choose Open With, then pick an app — or drag the file onto an app’s icon.
Always open .md files with the same app
- 1Select an .md file in Finder and choose File → Get Info.
- 2Expand Open with and choose the app.
- 3Click Change All to use it for every .md file.
See it formatted
- Apple Notes (macOS Tahoe 26 and later): choose File → Import Markdown, select the .md file, and click Import. Notes converts the Markdown to formatted text in an “Imported Notes” folder. It’s an import (a copy), not a live view of the file.
- Quick Look (Space bar in Finder): Apple doesn’t document a rendered Markdown preview, and in practice Quick Look shows the raw text unless you install a third-party Quick Look extension, such as the open-source markdown-preview-quicklook.
- TextEdit isn’t a Markdown app — Apple doesn’t list Markdown among its formats — so it shows the raw text.
- For a live, formatted view, use the browser method above, VS Code, or a Markdown editor such as Obsidian or Typora.
Linux
Desktops treat Markdown as a kind of plain text, so .md files open in your default text editor (GNOME Text Editor, gedit, and Kate highlight the syntax). To see it rendered:
- Kate (KDE): enable the Document Preview plugin and open View → Tool Views → Show Preview. Markdown preview needs the KMarkdownWebView (sometimes packaged as
markdownpart) or Okular part installed. - Apostrophe (GNOME): a Markdown editor with a live preview, available from GNOME’s app catalog.
- Or use the browser method — it works in Firefox and Chromium on any distribution.
iPhone & iPad
Read it formatted in Safari (any iOS version)
- 1Open MarkdownPreview.net in Safari.
- 2Tap Open File, then choose the .md file from the Files picker.
- 3The document opens in a full-width reading view; tap Edit to change it.
Save it to Apple Notes (iOS / iPadOS 26 and later)
- 1In the Files app, touch and hold the .md file and tap Share.
- 2Tap Notes, then save it as a new note. Notes converts the Markdown to formatted text.
Android
Android has no built-in Markdown viewer, so tapping an .md file offers whatever apps can open text. The simplest formatted option is the browser method:
- 1Open MarkdownPreview.net in Chrome.
- 2Tap Open File and pick the file from your downloads or file manager.
Change which app opens .md files
When Android asks which app to use, choose one and tap Always (or Just once). To undo a choice, go to Settings → Apps → the app → Open by default → Clear default preferences. Menu names can vary by manufacturer.
Microsoft Word, Google Docs & OneDrive
Microsoft Word
Word doesn’t support Markdown as a file format (it isn’t in Microsoft’s list of Word file formats). Two ways in: convert the file to .docx with MDConverter.net, or open it in MarkdownPreview.net, choose Export → Copy Rich Text, and paste into Word — headings, lists, tables, and links keep their formatting.
Google Drive & Docs
- New in October 2026: Drive previews .md files natively (right-click → Open with → Preview, then switch between Markdown and Preview), and double-clicking opens them in Docs’ “Markdown mode”, editing the .md file directly. Google began rolling this out on October 5, 2026; it can take up to about two weeks to reach every account.
- Import and export (since 2024): upload an .md file and open it with Google Docs to convert it to a Doc, or save any Doc with File → Download → Markdown (.md).
Step-by-step menus, limits, and what Google doesn’t document are in our Markdown in Google Docs guide.
OneDrive & SharePoint
Microsoft added native Markdown support to OneDrive and SharePoint on the web in 2026, with View, Edit, and Split modes — open the .md file there to read it formatted.
At a glance: every platform
| Platform | Open as text | See it formatted | Built-in rendering? |
|---|---|---|---|
| Any browser | MarkdownPreview.net | MarkdownPreview.net (drag & drop) | No install needed |
| Windows 11 | Notepad | Notepad formatting (rolling out), PowerToys preview | Partly |
| Windows 10 | Notepad | PowerToys preview pane, an editor, or a browser | No |
| Mac | TextEdit or any editor | Apple Notes import (macOS 26+), a Quick Look extension, an editor, or a browser | Import only |
| Linux | Default text editor | Kate preview plugin, Apostrophe, or a browser | Depends on desktop |
| iPhone / iPad | Files | Share to Notes (iOS 26+), or a browser | Import only |
| Android | A text editor app | A browser-based previewer | No |
| Google Drive / Docs | Drive | Native preview and editing (from Oct 2026) | Yes |
| OneDrive / SharePoint | Web | Native Markdown viewer and editor (2026) | Yes |
| Microsoft Word | — | Convert first, or paste rendered rich text | No |
Troubleshooting
The file is actually named something.md.txt
Windows hides known extensions by default, so a file saved as .md.txt looks like .md. In File Explorer, choose View → Show → File name extensions (Windows 11) or tick File name extensions on the View tab (Windows 10), then rename it.
It opens in the wrong app
Change the default app for .md using the Windows, Mac, or Android steps above — the setting is per extension, so set .markdown too.
I see # and ** symbols everywhere
That's the raw Markdown — the file is fine. Open it in a Markdown viewer (the browser method, VS Code's preview, or a built-in option above) to see it formatted.
Images in the document don't show
Markdown images are links to separate files. If the images live next to the .md file (for example in a repository), open the file from its original location — on GitHub, view it on github.com, where relative image paths resolve.
Every platform step and feature in this guide comes from the vendor’s own documentation or announcements — Microsoft Support and Windows Insider posts, Apple Support, KDE and GNOME, Google Workspace Updates, and the IETF — listed in the sources below, checked on the date shown at the top.
Where vendors haven’t said something officially, we say so: for example, Microsoft has only described Notepad’s Markdown formatting as rolling out through Insider channels, so we don’t claim every Windows 11 PC has it. Spot an update? Email hello@markdownpreview.net.
Frequently asked questions
What program opens .md files?
Is an .md file safe to open?
How do I open an .md file in Word?
Can Google Docs open .md files?
What is the difference between .md and .markdown?
How do I convert an .md file to PDF?
Sources
- RFC 7763 — The text/markdown Media Type — definition and the .md / .markdown extensions
- Microsoft — Change default apps in Windows
- Windows Insider Blog — Text formatting in Notepad (May 30, 2025)
- Microsoft Learn — Notepad Insider release notes
- Microsoft Learn — PowerToys File Explorer add-ons
- Microsoft Learn — PowerToys Peek
- Apple — Choose an app to open a file on Mac
- Apple — Import notes and attachments to Notes (Markdown)
- GitHub — markdown-preview-quicklook (third-party Quick Look extension) — adds rendered Markdown to Quick Look
- KDE — Kate Document Preview plugin
- GNOME Apps — Apostrophe
- Google — Set default apps on Android (Pixel Help)
- Google Workspace Updates — Markdown files natively across Drive and Docs (Oct 2026)
- Google Workspace Updates — Import and export Markdown in Google Docs (Jul 2024)
- Microsoft Tech Community — Markdown support in SharePoint and OneDrive (Apr 2026)
- Microsoft Learn — Office file format reference — no Markdown format listed for Word