Build from source · Linux release on roadmap MDHero — open source markdown viewer for Linux

MDHero on Linux.
Build it from source today.

A free, open source markdown viewer and lightweight editor — buildable on Linux in about 5 minutes if you have Rust and Node.

No pre-built .deb or .AppImage yet — we ship them once enough Linux users ask. Until then, the build path is simple and the binary that drops out is the same Tauri + Rust core as macOS and Windows.

Tested on Ubuntu 22.04+, Fedora 38+, Arch. Other distros likely work — Tauri uses standard webkit2gtk.

Same MDHero — same Tauri + Rust core, same ~8MB footprint.

Everything that works on macOS and Windows works on Linux too. The only difference is you build the binary yourself for now.

Built with Tauri + Rust

Same native core as the macOS and Windows builds. No Electron, no Node runtime in the binary, no Chromium tax. Webkit2gtk on Linux means it integrates with your system browser engine.

The full feature set

Syntax highlighting for 25+ languages, KaTeX math, Mermaid diagrams, tabs, Table of Contents, pinned folders, Vim keybindings, dark mode. Building from source gives you all of it.

Editor mode included

Press Ctrl+E on any local file to flip into a focused editor. Ctrl+S saves to disk. Source-line scroll sync across viewer, raw, and edit modes.

LLM paste mode

Paste output from ChatGPT, Claude, or Gemini and MDHero auto-detects the escaped \n formatting and renders clean markdown. Works the same across every platform.

No telemetry, no account

Same privacy story as the other platforms — your files never leave your machine, no usage data is collected, no account is required to use the app.

Help us prioritize the binary

Pre-built .deb, .AppImage, and .rpm are on the roadmap. We'll prioritize once enough users ask — file an issue if you'd use it.

Install · Linux

No pre-built binary yet — build from source in 5 minutes.

MDHero doesn't currently ship a pre-built Linux binary. Linux support is on the roadmap. Until then, you can build from source — the process takes about 5 minutes if you have Rust and Node installed.

1. Install prerequisites

Rust (one-time):

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Node.js 20+ and pnpm:

npm install -g pnpm

Linux dev libraries (Debian/Ubuntu — adjust for your distro):

sudo apt install -y \
  libwebkit2gtk-4.1-dev \
  build-essential \
  curl wget file \
  libxdo-dev \
  libssl-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev

2. Clone and build MDHero

git clone https://github.com/vaibhavuk-dev/mdhero.git
cd mdhero
pnpm install
pnpm tauri build

3. Run the binary

./src-tauri/target/release/mdhero

Or install the .deb / .AppImage from src-tauri/target/release/bundle/.

Want a pre-built Linux binary?

Request Linux release on GitHub

Adding .deb, .AppImage, and .rpm builds to CI is straightforward — we'll prioritize based on demand.

Tested distros

Community-reported as working: Ubuntu 22.04+, Fedora 38+, Arch (current). Other distros likely work too — Tauri uses standard webkit2gtk.

Open source, MIT licensed, runs on your Linux box.

Build it once. The binary launches in under a second after that — same as on macOS and Windows.

Also available for Mac and Windows.