# MDHero: A Markdown viewer and editor Windows was missing

> Source: <https://mdhero.app/windows/>
> Published: 2026-08-05 12:13:30+00:00

# A markdown viewer and editor

Windows was missing.

A free, open source markdown viewer for Windows and a lightweight editor — small, fast, and native.

Under 8MB. The free markdown viewer Windows users actually want — a real .md file viewer that opens any markdown document with a double-click. Built with Tauri and Rust. Press `Ctrl+E`

to edit and `Ctrl+S`

to save — no accounts, no uploads.

`Windows 10+`

(64-bit). Installer is a standard .exe setup.## Why Windows users choose MDHero as their markdown viewer for Windows

### Tiny footprint, zero bloat

Under 8MB installed — roughly 20x smaller than MarkText or VS Code. No Electron runtime, no bundled Node.js. Runs on Tauri and Rust for native Windows performance.

### Proper code rendering

Syntax colors for 25+ languages that look sharp on any display. KaTeX for LaTeX equations, Mermaid for flowcharts. Themes follow your Windows light/dark preference.

### Clean up AI output instantly

Copy from ChatGPT, Claude, or Gemini and paste into MDHero. LLM paste mode strips the escaped newlines and broken formatting so you can actually read the response.

### View, Split, or Edit

A real markdown editor for Windows, built into the viewer. Switch between View, Split, and Edit from one control — Split shows the editor and a live preview side by side. Line numbers, `Ctrl+S` to save, and an unsaved-changes warning before you close.

### Present straight from a .md file

Add `marp: true`

to the front matter and MDHero opens the file as a native slideshow — arrow keys, `Space`, and optional page numbers. No Marp CLI, no export, no browser.

### Ctrl+T, Ctrl+F, done

Familiar Windows keyboard shortcuts. Tabbed interface with drag-to-reorder, a Table of Contents sidebar for long documents, and pin your project folders for quick access.

### Open .md files from Explorer

Set MDHero as the default handler to open .md files on Windows. Double-click any markdown document in Explorer to view it rendered. Also opens GitHub URLs and Claude Code plans.

### Offline and private by design

Your files stay on your PC. Nothing is uploaded, no account is required, no usage data is collected. Works without an internet connection — ideal for air-gapped or corporate environments.

## How MDHero compares on Windows

Most markdown viewers on Windows are either editors, Electron-based, or paid. MDHero is different.

| MDHero | Typora | MarkText | Markdown Monster | MarkView | |
|---|---|---|---|---|---|
| Price | Free | $14.99 | Free | $39 | Free |
| Open source | Yes | No | Yes | No | No |
| App size | ~8MB | ~90MB | ~170MB | ~80MB | ~100MB |
| Viewer + editor | Both | Editor only | Editor only | Editor only | Viewer only |
| Mermaid diagrams | Yes | Yes | No | Yes | Yes |
| LLM paste mode | Yes | No | No | No | No |
| Still maintained | Yes | Yes | No (2022) | Yes | Yes |

## First run takes one extra click. SmartScreen warning, bypass, done.

MDHero is open source and not signed with a Microsoft Authenticode certificate (that's $200–700/year from a certificate authority, which we haven't taken on yet). On first run, Windows SmartScreen shows a warning. Here's how to bypass it once.

### Steps

- Download
`MDHero_0.2.8_x64-setup.exe`

(or the`.msi`

if you prefer) - Double-click the downloaded file
- Windows SmartScreen shows:
*Windows protected your PC. Microsoft Defender SmartScreen prevented an unrecognized app from starting.* - Click the small
**More info** link in the dialog text - A new button appears:
**Run anyway**— click it - Follow the installer steps (default settings are fine)
- MDHero is now in your Start menu and works normally

## What's safe about this?

- MDHero is fully open source — every line of code is on
[GitHub](https://github.com/vaibhav-kakde-in/mdhero). - The Windows binary is built on GitHub Actions from public source on every release.
- The "unrecognized app" warning is what Windows shows for any unsigned binary, including thousands of legitimate open-source apps.

## Markdown on Windows — common questions

The questions people ask before picking a markdown viewer for Windows.

## ### Is there a free markdown viewer for Windows?

**Yes.** MDHero is a completely free, open-source markdown viewer for Windows 10 and 11 — about 8MB, MIT-licensed, with no paid tier, no account, and no ads.

It renders GitHub-Flavored Markdown with syntax-highlighted code, KaTeX math, and Mermaid diagrams, and includes a lightweight editor (`Ctrl+E` to edit, `Ctrl+S` to save). See how it stacks up in our [best free markdown viewers comparison](/blogs/best-free-markdown-viewers-2026/).

## ### How do I open a .md file on Windows 10 or 11?

Windows has no built-in markdown renderer — double-clicking a `.md`

file opens Notepad showing raw text. Install a markdown viewer like MDHero, then double-click any `.md`

file in File Explorer to see it rendered.

To make it the default: right-click a `.md`

file → *Open with* → *Choose another app* → MDHero → check *Always*. Full walkthrough: [how to open .md files on Windows](/blogs/open-md-windows/).

## ### Does Windows have a built-in markdown viewer?

**No.** Neither Windows 10 nor Windows 11 ships with a markdown renderer — Notepad and WordPad show `.md`

files as raw text with visible `#`

and `*`

symbols.

You need a third-party app: MDHero is a free 8MB option, while alternatives like Typora ($14.99) or MarkText (~170MB, unmaintained since 2022) are heavier. The comparison table above covers the trade-offs.

## ### Why does Windows SmartScreen warn me about MDHero?

The warning appears because MDHero’s installer has not yet built up reputation with Microsoft’s SmartScreen system — not because anything is wrong with the app. Click *More info*, then *Run anyway*; it only happens on the first run.

MDHero is MIT open source and every Windows binary is built on public [GitHub Actions CI](https://github.com/vaibhav-kakde-in/mdhero), so the code behind the installer is fully auditable. Step-by-step: [install guide above](#install).

## ### Can MDHero edit markdown files on Windows, or only view them?

**Both.** MDHero opens as a clean reader, and `Ctrl+E` flips any local file into a lightweight editor with the scroll position preserved line by line; `Ctrl+S` saves to disk.

It is a focused viewer-first app, not a full IDE — for reading-first workflows with quick edits it replaces both Notepad and a heavyweight editor.

## More on opening markdown files on Windows

Guides and comparisons from the MDHero blog.

[Guide](/blogs/open-md-windows/)

### How to open .md files on Windows

Every reasonable way to view markdown on Windows 10 and 11 — Notepad, VS Code, Chrome, MDHero — compared.

[Roundup](/blogs/best-free-markdown-viewers-2026/)

### Best free markdown viewers in 2026

The shortlist of free markdown apps for Windows, Mac, and beyond — with honest pros and cons.

[Tutorial](/blogs/paste-chatgpt-output-fix-newlines/)

### Fix ChatGPT paste formatting on Windows

Why AI output looks broken when you paste it, and how MDHero's LLM paste mode fixes it instantly.

Cross-platform user? See the [Mac markdown viewer page](/mac/), or browse [all MDHero articles](/blogs/).

## Free, open source, and built for Windows.

Download MDHero and start viewing markdown files in seconds.

Also available as a [markdown viewer for Mac](/mac/).
