How to Open a Markdown File: On Windows, Mac, Mobile, and Online

Q: Can I open a Markdown file in Microsoft Word?

Word doesn't render Markdown natively: opening a `.md` file in Word just shows the raw syntax as plain text. If you want the formatted content inside an actual Word document, convert the file to `.docx` first, for example with Pandoc (`pandoc notes.md -o notes.docx`), then open the result in Word.

Q: Is it safe to change a .md file's extension to .txt to open it?

Yes. A `.md` file is already plain text, so renaming it to `.txt` changes nothing about the content, only which app your OS defaults to opening it with. You can rename it back to `.md` at any time without losing anything.

You downloaded something (a README, an AI chatbot's export, a note from a colleague) and it ended in .md. You double-click it and either nothing happens, or it opens as a wall of text with stray # symbols and asterisks scattered through it. Nothing is broken. A .md file is just plain text written in Markdown, a lightweight formatting syntax, and depending on what you open it with, you'll either see that raw syntax or a cleanly rendered page with real headings, bold text, and lists.

Here's how to open one properly on every platform, and what to do if you need to hand it to someone who's never heard of Markdown.

The Quick Answer

Just need to read it once? Open it in any text editor: the content is all there, just not formatted.
Want it rendered properly? Use a code editor like VS Code, a note app like Obsidian, or a dedicated Markdown viewer.
Need to send it to someone non-technical? Convert it to PDF or Word first (see the section below).

On Windows

Any text editor opens a .md file, since it's nothing more than plain text (usually UTF-8). Right-click the file, choose Open with, and pick Notepad. Older versions of Notepad show the raw syntax; newer ones can also show it formatted (see below).

For formatted rendering, you have two solid free options:

Notepad (Windows 11, 2025 and later). Microsoft began rolling out Markdown formatting in Notepad to Windows Insiders in May 2025: a formatting toolbar for headings, lists, bold, italic and links, plus a switch between the formatted view and the raw Markdown syntax. If your Notepad has the update, open the file and switch views from the View menu or the toggle in the status bar at the bottom of the window.
VS Code. Free, and the most reliable rendering of the two. Open the file, then press Ctrl+Shift+V to pop open a rendered preview tab (or Ctrl+K then V for side-by-side editing and preview).

On Mac

TextEdit opens .md files as plain text: fine for a quick read, no formatting. For rendered output:

VS Code. Same shortcut as Windows, with Cmd instead of Ctrl: Cmd+Shift+V.
Obsidian or Typora. Both are apps built around Markdown as their native format. Obsidian is free for personal and commercial use; Typora is a one-time paid purchase after a 15-day trial (both checked 2026-11-07). In Typora, just open the file; in Obsidian, drop it into your vault and it renders immediately. If you're setting one up for the first time, see our guide on converting files to Markdown for Obsidian.

On Mobile (Android and iOS)

The stock Files app (iOS) or your file manager (Android) may show a .md file as plain text or offer no preview at all. For a rendered view, search your app store for a dedicated Markdown viewer or editor. There are several free ones on both platforms, with the usual tradeoffs between a bare-bones viewer and a full editor with cloud sync. If you only need to glance at the file once, plain text is often good enough; the # and ** markers are still legible even unrendered.

In Your Browser, No Install

If you don't want to install anything:

GitHub. If the file is (or can be) in a GitHub repository, GitHub renders Markdown automatically in the file view, no setup needed.
Paste it into an online viewer. Several free sites accept pasted Markdown text or a file upload and render it instantly in the browser tab. Fine for a one-off, but treat sensitive content the way you would with any third-party upload tool: prefer a local editor like VS Code if the file contains anything private.

When Plain Text Isn't Enough: Converting a .md File to Something Anyone Can Open

Sometimes the person on the other end doesn't have (and shouldn't need) a Markdown-aware app. If you need to hand off the content as a PDF or Word document instead, that's a different problem from opening the file yourself. For PDF, we've written a full breakdown: Markdown to PDF Converter: 5 Free Ways to Export .md Files, covering the browser print trick, Pandoc, a Node CLI, and a VS Code extension. For Word, Pandoc writes a .docx directly: pandoc notes.md -o notes.docx.

Going the Other Direction

If you're less often the person opening .md files and more often the person who needs to create them (you've got a PDF, a Word document saved as .docx, an Excel or CSV file, or a Confluence page exported as PDF or HTML, and you need clean Markdown out the other end for an LLM prompt, a RAG pipeline, or an Obsidian vault), that's what file2markdown does. Upload the file at file2markdown.ai/convert and get Markdown back in seconds, no install required. It only works in that direction: it doesn't open, preview or convert .md files, and the upload doesn't accept them. We have dedicated converter pages for the most common sources: PDF to Markdown, Word documents, and HTML pages. If the destination is an AI assistant rather than a notes app, see how to prepare Markdown for Claude and why LLMs prefer Markdown in the first place.

Frequently Asked Questions

Why does my .md file look like a wall of text with # and * symbols?

Because you're viewing the raw Markdown syntax rather than the rendered output. The # symbols mark headings and * or ** mark italic and bold text; they're meant to be interpreted by a Markdown-aware viewer (VS Code, Obsidian, GitHub) rather than read literally. The content isn't corrupted; you're just one rendering step away from the formatted version.

Can I open a Markdown file in Microsoft Word?

Word doesn't render Markdown natively: opening a .md file in Word just shows the raw syntax as plain text. If you want the formatted content inside an actual Word document, convert the file to .docx first, for example with Pandoc (pandoc notes.md -o notes.docx), then open the result in Word.

Is it safe to change a .md file's extension to .txt to open it?

Yes. A .md file is already plain text, so renaming it to .txt changes nothing about the content, only which app your OS defaults to opening it with. You can rename it back to .md at any time without losing anything.

What's the fastest way to view a Markdown file without installing anything?

If it's in a GitHub repository, just view it there: GitHub renders Markdown automatically. Otherwise, paste the contents into any free online Markdown viewer, or open it in your browser directly and use an extension that renders local .md files. For regular use, though, a code editor like VS Code is worth the one-time install: it's free and renders Markdown instantly with Ctrl+Shift+V.