FAQ · the questions visitors actually ask

MDHero — Common questions, answered straight.

The things people most often ask about MDHero before downloading — pricing, privacy, sync, install, and how it stacks up against Typora, Obsidian, and VS Code. Short answers first, links to deeper docs below each one.

What is MDHero and is it free?

MDHero is a free, open-source markdown viewer and lightweight editor for macOS and Windows, distributed under the MIT license. The desktop app is ~8MB, runs entirely offline, and will stay free forever — there is no paid tier and no plan to add one for the local app.

The source code is on GitHub at github.com/vaibhavuk-dev/mdhero, and every release is built from public GitHub Actions CI. You can audit it, fork it, or build it from source.

What data does MDHero collect or upload?

MDHero collects no usage data. The only network call is a once-per-24-hours update check to mdhero.app/api/version that sends your current version and OS family (darwin or win32).

There are no device IDs, no IP storage, no file contents, no analytics scripts, and no third-party trackers. All markdown files stay on your machine. The update endpoint source is public so the disclosure is verifiable — see src/pages/api/version.ts in the website repo.

How does MDHero compare to Typora, Obsidian, and VS Code?

MDHero is roughly 20× smaller than the alternatives — ~8MB versus Typora ~90MB, Obsidian ~180MB, and VS Code ~300MB — because it is built with Tauri and Rust instead of Electron.

It is free and open source under MIT, whereas Typora costs $14.99 and is closed source. Unlike Obsidian or VS Code, MDHero is a focused viewer with a lightweight in-place editor (Cmd+E to edit, Cmd+S to save), not a full knowledge base or IDE. See our detailed comparison on best free markdown viewers in 2026.

Can MDHero sync markdown files between Mac and Windows?

MDHero does not include its own sync. It reads .md files from wherever they live, so placing your markdown folder in iCloud Drive, Dropbox, OneDrive, Syncthing, or a git repository lets both Mac and Windows installations see the same files.

This avoids creating another proprietary sync silo on top of services that already solve the problem well, and it means your notes are never locked into MDHero — they are just plain markdown text files.

How do I install MDHero on macOS and Windows?

On macOS (Apple Silicon, M1 through M4), download the .dmg from mdhero.app/mac, drag MDHero to Applications, and double-click. The DMG is Apple-notarized as of v0.2.4, so no Gatekeeper workaround is needed.

On Windows 10 or 11, download the .exe installer from mdhero.app/windows and click More info then Run anyway past the SmartScreen warning once. After the first launch, both platforms run normally from then on.

Detailed step-by-step guides: macOS install · Windows install.

Can MDHero render ChatGPT or Claude markdown output cleanly?

Yes. MDHero has an LLM paste mode (Cmd+Shift+V on Mac, Ctrl+Shift+V on Windows) that auto-detects escaped \n characters from AI clipboard output and renders clean markdown.

This solves the common problem where copying from ChatGPT, Claude, or Gemini produces literal \n newlines and stray backslashes when pasted into other apps. MDHero also reads Claude Code plans directly from ~/.claude/plans. See our deep-dive on fixing ChatGPT paste formatting.

Does MDHero work offline?

Yes. MDHero runs fully offline — it reads and renders local markdown files with no internet connection required.

The only network request it ever makes is a once-per-24-hours update check to mdhero.app/api/version. Block that endpoint and the app still works completely; nothing else depends on the network, and no file contents ever leave your machine. This makes it suitable for air-gapped and corporate environments.

What file formats does MDHero open?

MDHero opens .md, .markdown, and .mdx files, plus GitHub URLs, raw pasted markdown (Cmd+Shift+V), and Claude Code plan files from ~/.claude/plans.

It renders GitHub-Flavored Markdown including tables, task lists, footnotes, syntax-highlighted code in 25+ languages, KaTeX math, and Mermaid diagrams. It is a viewer and lightweight editor, not a converter — it does not currently export to PDF or Word.

Is MDHero safe to install?

Yes. MDHero is fully open source under the MIT license, so every line of code is auditable on GitHub.

The macOS build is signed with an Apple Developer ID and notarized by Apple (Apple has scanned it for malware). Both the macOS and Windows binaries are built automatically on public GitHub Actions CI from public source — no manual step where something could be tampered with. It collects no telemetry and requires no account.