File Guide

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.

Updated 9 min readBy the MarkdownPreview.net team
Quick answer

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.

  1. 1Open MarkdownPreview.net.
  2. 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).
  3. 3Read it in the preview. Use Read for a full-width view and Outline to jump between sections.
  4. 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

  1. 1Right-click the file and choose Open with → Choose another app.
  2. 2Pick Notepad (plain text), VS Code, or another Markdown app.

Always open .md files with the same app

  1. 1Open Settings → Apps → Default apps.
  2. 2Type .md in the search box under file types and select it.
  3. 3Choose the app you want. Repeat for .markdown if 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

  1. 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

  1. 1Select an .md file in Finder and choose File → Get Info.
  2. 2Expand Open with and choose the app.
  3. 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)

  1. 1Open MarkdownPreview.net in Safari.
  2. 2Tap Open File, then choose the .md file from the Files picker.
  3. 3The document opens in a full-width reading view; tap Edit to change it.

Save it to Apple Notes (iOS / iPadOS 26 and later)

  1. 1In the Files app, touch and hold the .md file and tap Share.
  2. 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:

  1. 1Open MarkdownPreview.net in Chrome.
  2. 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

PlatformOpen as textSee it formattedBuilt-in rendering?
Any browserMarkdownPreview.netMarkdownPreview.net (drag & drop)No install needed
Windows 11NotepadNotepad formatting (rolling out), PowerToys previewPartly
Windows 10NotepadPowerToys preview pane, an editor, or a browserNo
MacTextEdit or any editorApple Notes import (macOS 26+), a Quick Look extension, an editor, or a browserImport only
LinuxDefault text editorKate preview plugin, Apostrophe, or a browserDepends on desktop
iPhone / iPadFilesShare to Notes (iOS 26+), or a browserImport only
AndroidA text editor appA browser-based previewerNo
Google Drive / DocsDriveNative preview and editing (from Oct 2026)Yes
OneDrive / SharePointWebNative Markdown viewer and editor (2026)Yes
Microsoft Word—Convert first, or paste rendered rich textNo

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.

How we verified this guide

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?

Any text editor can open an .md file, because it is plain text: Notepad, TextEdit, VS Code, and so on. To see it formatted — headings, bold text, tables — you need a Markdown viewer: an online previewer like MarkdownPreview.net, an editor with a preview (VS Code, Obsidian, Typora), or a platform with built-in support such as Google Drive or OneDrive on the web.

Is an .md file safe to open?

An .md file is plain text, so opening it in a text editor or viewer cannot run code by itself. Viewers should still sanitize embedded HTML — MarkdownPreview.net removes scripts and event handlers from the rendered output — and, as with any file, be careful with links inside documents from unknown senders.

How do I open an .md file in Word?

Word does not open Markdown natively. Either convert it to .docx first (for example with MDConverter.net), or open the file in MarkdownPreview.net, choose Export → Copy Rich Text, and paste into Word — headings, lists, tables, and links keep their formatting.

Can Google Docs open .md files?

Yes. Since a rollout that began on October 5, 2026, Google Drive previews .md files and Google Docs can edit them in "Markdown mode" while keeping them as .md files. Earlier, Docs could already import a .md file (converting it to a Doc) and download any document as Markdown.

What is the difference between .md and .markdown?

Nothing — both are registered extensions for the same text/markdown format. .md is far more common, and README.md is the conventional name for a project's front page on GitHub.

How do I convert an .md file to PDF?

Open it in MarkdownPreview.net and choose Export → PDF, which prints the rendered document through your browser. For Word, PowerPoint, or batch conversion, use MDConverter.net.

Sources

Open your .md file now
Drag it into the viewer — formatted instantly, never uploaded.
Open Markdown Viewer

More Markdown Tools & Guides

All tools are free, run in your browser, and require no account.

Live Markdown PreviewerTool

Edit Markdown with a real-time preview, Mermaid, KaTeX math, drag-and-drop files, and one-click export.

Open the tool
GitHub Markdown PreviewTool

Load any public README, test it, and look up any GitHub syntax in the complete cheat sheet.

Open the tool
Mermaid Live EditorTool

13 diagram types with examples, live rendering, and SVG/PNG download.

Open the tool
LaTeX Math PreviewTool

Typeset equations as you type, with a copy-ready KaTeX cheat sheet of 180+ commands.

Open the tool
README Template GeneratorTool

Pick sections, fill in your project, and download a GitHub-ready README.md with badges and a TOC.

Open the tool
AI Markdown ViewerTool

Paste ChatGPT, Claude, or Gemini output and read it formatted, with tables, code, and math.

Open the tool
What Is Markdown?Guide

A plain-English introduction: what Markdown and .md files are, where it came from, and where it is used.

Read the guide
Markdown in Google DocsGuide

Preview .md files in Drive, edit in Docs' Markdown mode, and paste, convert, or export Markdown.

Read the guide
Best Online Markdown ViewersGuide

Six free tools tested with the same document: rendering, privacy, and phone support compared.

Read the guide
GitHub Markdown Not Rendering?Guide

16 causes found by symptom — tables, lists, image paths, code fences, alerts, Mermaid, math — with tested fixes.

Read the guide
Markdown Preview in VS CodeGuide

Preview shortcuts, settings verified on VS Code 1.141, built-in Mermaid and math, extensions, and fixes.

Read the guide
Markdown Preview in Any EditorGuide

Exact preview shortcuts for Visual Studio, JetBrains, Zed, Xcode, Sublime, Neovim, Obsidian, and more.

Read the guide
Preview Markdown in a BrowserGuide

Six free ways to read .md files in Chrome, Edge, Firefox, or Safari — compared for privacy and features.

Read the guide