You've downloaded a project from GitHub. Or a colleague sent you a README.md. Or you're writing documentation and want to check how it renders. The problem is the same every time: the raw file is full of # symbols, asterisks, and backtick fences that are unreadable at a glance.

The classic solution — install VS Code, install a Markdown preview extension, install Node, configure a linter — is overkill when you just want to read a file. This guide shows you how to view a Markdown file online, render any .md or .markdown file beautifully, and keep the whole workflow in your browser with zero installation.

What is a Markdown file?

Markdown is a lightweight markup language created by John Gruber in 2004. It uses simple punctuation characters to indicate formatting: a # at the start of a line becomes a heading, **bold** renders as bold, and a triple backtick fence creates a syntax-highlighted code block.

Files with the extension .md or .markdown are plain-text Markdown files. They are everywhere:

Because .md files are plain text, you can open them in any text editor — but you'll see the raw syntax, not the rendered output. A Markdown viewer interprets that syntax and renders it as formatted HTML, giving you headings, tables, code blocks, and images as intended.

Why open a .md file online?

There are several scenarios where an online Markdown viewer is the fastest tool for the job:

How to view a Markdown file online — step by step

MD Viewer is a free, fully browser-based Markdown viewer online. Nothing is installed, nothing is uploaded. Here is how to use it:

  1. Open MD Viewer in your browser.
    Navigate to md-viewer.fr. The app loads instantly — no sign-up, no account required.
  2. Click Open File.
    The button is in the top toolbar. Your browser's native file picker opens.
  3. Select your .md or .markdown file.
    Pick the file from your computer. Only files with .md and .markdown extensions are accepted.
  4. The file renders immediately.
    MD Viewer parses the Markdown and displays the formatted output: headings, paragraphs, bold and italic text, tables, task lists, and syntax-highlighted code blocks.
Tip: You can also drag and drop a .md file directly onto the browser window — no need to click any buttons. This works with both single files and entire folders.

View an entire folder of Markdown files

Most real-world Markdown projects aren't a single file — they're a folder full of .md files organized into subdirectories. MD Viewer's folder mode handles this natively.

  1. Click Open Folder in the toolbar (or drop a folder onto the window).
  2. Select the root directory of your project or documentation set. Your browser will prompt you to confirm folder access — this is a standard browser security dialog; the files are never uploaded anywhere.
  3. A file tree appears in the left sidebar.
    All .md files and subdirectories are listed. Folders can be expanded and collapsed. A search bar at the top filters files by name.
  4. Click any file to render it.
    The content area updates immediately. A document outline panel on the right lists all headings, letting you jump to any section instantly.

This is especially useful for browsing documentation libraries, project wikis, or Obsidian vaults — any collection of Markdown files where you want to navigate between documents without leaving the viewer.

What Markdown features are rendered?

MD Viewer uses marked.js with GitHub Flavored Markdown (GFM) enabled and highlight.js for code blocks. The following elements are fully supported:

Feature Syntax example
Headings (H1–H6) # Heading 1 … ###### Heading 6
Bold & italic **bold**, *italic*, ***both***
Links & images [text](url), ![alt](url)
Tables GFM pipe syntax with alignment
Task lists - [x] Done, - [ ] Todo
Fenced code blocks Triple backtick with language identifier
Inline code `code`
Blockquotes > quoted text
Strikethrough ~~deleted~~
Ordered & unordered lists 1., -, *
Horizontal rules ---
Autolinks URLs are auto-linked

Code blocks are highlighted for over 190 programming languages, including JavaScript, Python, TypeScript, Rust, Go, Bash, SQL, YAML, JSON, and many more. The syntax theme matches the app's dark interface by default, and switches to a light variant when you toggle the theme.

What about HTML in Markdown?

Raw HTML embedded in Markdown files is sanitized by DOMPurify before rendering. This prevents cross-site scripting (XSS) attacks, which is especially important when opening files from untrusted sources. Safe HTML elements like <details>, <summary>, and <kbd> are preserved; potentially dangerous attributes and tags are stripped.

Your files never leave your browser

This deserves its own section because it's a meaningful difference from some other online tools.

MD Viewer is a static web application. It has no backend server, no database, and no file upload endpoint. When you open a .md file, the browser reads it from your local disk using the File System Access API (or a standard <input type="file"> element as a fallback). The file content stays in the browser's memory and is never transmitted over the network.

This makes MD Viewer safe for:

Alternatives to MD Viewer

There are other ways to view Markdown online. Here's a quick comparison so you can choose the right tool for your situation:

Tool Best for Files stay local?
MD Viewer Viewing local .md files and folders, privacy-conscious users Yes — 100% local
Dillinger.io Editing Markdown with a live split-pane preview Mostly — cloud sync optional
StackEdit Full-featured online editor with cloud storage No — syncs to Google Drive / Dropbox
GitHub Viewing README.md files in public repositories N/A — files are already on GitHub
VS Code + extension Daily development workflow Yes — but requires installation
Obsidian Long-form note-taking linked across many files Yes — but requires installation

If your priority is opening a file right now, in a browser, without creating an account or uploading anything, MD Viewer is the fastest path.

Try it now — no installation required

Drag and drop a .md file onto the app, or click Open File to browse your computer.

Open MD Viewer

Frequently asked questions

Can I view Markdown on my phone or tablet?

Yes. MD Viewer is a responsive web app and works in mobile browsers (Chrome for Android, Safari for iOS, Firefox for Android). The sidebar collapses automatically on small screens. Folder access works on desktop browsers; on mobile, use Open File to pick individual files from your device.

Does it work offline?

Once the page has loaded in your browser, Markdown rendering is fully local. The app uses marked.js, DOMPurify, and highlight.js — all loaded from CDN on first visit. After that initial load, you can open and read Markdown files without an internet connection, as long as the page is already open in your browser tab.

Can I view a Markdown file from a URL?

MD Viewer currently opens files from your local file system. To view a raw Markdown file from a URL (e.g. a GitHub raw file), you can save it to your computer first, then open it in MD Viewer. Alternatively, GitHub automatically renders .md files when you browse a repository.

What browsers are supported?

MD Viewer works in all modern browsers: Chrome, Edge, Firefox, and Safari. The Open Folder feature uses the File System Access API, which is supported in Chrome and Edge. In Firefox and Safari, a standard <input> element is used as a fallback — the experience is the same, but the browser may show a native file picker dialog instead.

Is the source code available?

The app is built from vanilla HTML, CSS, and JavaScript with no build step and no framework. The entire source is inspectable in your browser's DevTools.