Open .md Files Online

What is this file?

A Markdown file (.md or .markdown) is plain text written with simple formatting symbols: # for headings, **asterisks** for bold, dashes for lists and backticks for code. It is the standard format for README files on GitHub, software documentation, exported notes from apps like Obsidian and Notion, and countless project wikis. You typically meet one inside a downloaded project folder, attached to a message from a developer, or exported from your own notes app. The catch: most phones and many computers have no app that renders Markdown, so double-clicking shows the raw symbols instead of a readable page — the content is fine, but it looks like code.

How to open .md files on Windows

Windows has no built-in Markdown renderer: Notepad opens a .md file as raw text with all the # and ** symbols visible. Developers usually read Markdown in Visual Studio Code (which renders a preview side by side) or in the free MarkText app, and GitHub renders it automatically in the browser. If a colleague sent you a README or a documentation file and you only want to read it comfortably, this page renders it in your browser tab — no install, and it works on locked-down work computers too.

How to open .md files on Mac

On a Mac, double-clicking a .md file usually opens it in TextEdit as raw text, because no default app renders Markdown. Developers use Visual Studio Code or the free MacDown editor, and Obsidian renders Markdown notes natively. Quick Look in Finder may also show raw text only. If you just want to read the document as a formatted page, drop it into this viewer in Safari or Chrome — nothing to install, and the raw file stays untouched on your Mac.

How to open .md files on Android

Android has no built-in Markdown renderer, so a .md file usually opens as raw text in a file manager or chat app. Free apps such as Markor render Markdown properly with headings and lists, and Google Docs can import the text (formatting symbols included, unrendered). For a quick look — a README someone sent you, exported notes — this page renders the file in Chrome on your phone, locally, with the formatting applied and nothing uploaded.

How to open .md files on iPhone

iPhone has no Markdown app built in: the Files app and Mail show .md attachments as raw text. Apps such as Taio or the editor built into Obsidian render them nicely, but they are heavy if you only need to read one file — for example release notes or a document someone shared from their notes. This viewer renders the page in Safari on your phone instead, with headings and lists formatted, and the file itself never leaves the device.

Open it right here

If the file still won't open

If the page shows raw # and ** symbols, you are looking at the file in a plain text editor rather than a renderer — open it here or in a Markdown app instead. Missing images almost always mean the .md file points to image files that were not sent along with it, or to links that no longer work. Strange spacing is usually a flavour difference: GitHub-flavoured Markdown supports tables and task lists that stricter parsers show differently. A file that opens as total gibberish is probably not Markdown at all but a mis-named binary file. Password protection is not a Markdown feature, and files over 100 MB exceed this viewer's in-browser limit.

Private by design

Your Markdown file is read and rendered entirely inside your browser and is never uploaded — useful for unpublished drafts, internal documentation and private notes. Any HTML written inside the file is sanitized before display, there is no account, and local files open even work offline once this page has loaded.

CommonMark vs GFM: Why Do Markdown Flavors Look Different?

Markdown is fundamentally plain text structured with lightweight formatting symbols like `#` for headings, `**` for bold, and `-` for bullet lists, making it ubiquitous across GitHub documentation and note-taking systems. However, users frequently encounter rendering discrepancies because Markdown lacks a single universal standard. While CommonMark establishes baseline parsing rules, extensions like GitHub Flavored Markdown (GFM) introduce tables, task lists, and autolinks. Even more complex are modern note apps like Obsidian, which embed YAML frontmatter metadata, KaTeX math formulas, and internal wikilinks (`[[note]]`). Renaming a `.md` file to `.txt` never destroys data, but converting it to PDF or HTML demands a renderer that supports your specific flavor; otherwise, embedded syntax appears as raw unparsed text. Furthermore, standalone web viewers cannot resolve relative paths to external image assets stored on your local drive. When notes rely heavily on interactive Mermaid diagrams, relational database plugins, or bi-directional link graphs, a quick viewer is not enough—you need the original note app. For everyday inspection, our secure in-browser viewer safely parses standard syntax directly in your browser without uploading files. Note that password-protected containers cannot be opened, and files exceeding 100 MB cannot be previewed.

Frequently asked questions