繁體中文 | English
A lightweight, fully-local Markdown viewer & editor for Windows, macOS and Linux. Built with Tauri v2, it uses the operating system's built-in WebView (WebView2 on Windows, WKWebView on macOS, WebKitGTK on Linux) instead of bundling Chromium — so the Windows binary is only ~4 MB and idle memory stays around 30–60 MB.
Double-click a .md file and it opens instantly, beautifully rendered — with a
navigable outline, syntax highlighting, Mermaid diagrams, a built-in editor with
live preview, and one-click export to a self-contained HTML file. No installer
bloat, no cloud, no telemetry. Everything runs offline.
The left outline (TOC) is generated from the document's headings; click any entry to jump, and it highlights the section you're currently reading.
Press Edit (or Ctrl+E) to open the split editor. The preview updates as you
type, the two panes scroll together, and Ctrl+S saves back to disk.
- GFM rendering — tables, task lists, strikethrough (
markdown-it) - Syntax highlighting for code blocks (
highlight.js) - Mermaid diagrams — loaded lazily, only when a document actually contains a
```mermaidblock, so plain documents pay nothing for it - Outline / TOC sidebar — auto-built from headings, scroll-spy highlighting,
collapsible with
Ctrl+\ - Live edit & preview — split editor with synced scrolling (
Ctrl+E), save withCtrl+S, and an unsaved-changes prompt on close - Export to HTML — produces a single self-contained
.htmlnext to your file, including the outline sidebar, highlighted code and inline Mermaid SVGs - Live reload — the open file is watched on disk and re-rendered on save
- File association — double-click any
.md/.markdownfile to open it - Drag & drop a Markdown file onto the window
- Find in document (
Ctrl+F), open-file dialog (Ctrl+O) and a recent-files list - YAML front matter — the leading
---...---block renders as a clean metadata card (title, description, date, tags, draft badge) instead of broken rules - Local relative-path images —
resolves and displays - Safe — rendered HTML is sanitized with DOMPurify under a strict CSP, so opening an untrusted document won't run malicious scripts
- Light / dark theme follows the OS setting
- External links open in your default browser
Grab the latest build from the Releases page:
| Platform | File |
|---|---|
| Windows (installer, recommended) | Markdown.Viewer_*_x64-setup.exe or *_x64_en-US.msi |
| Windows (portable, no install) | Markdown.Viewer_*_x64_portable.exe |
| macOS (Apple Silicon / Intel) | *_aarch64.dmg / *_x64.dmg |
| Linux | *_amd64.AppImage, *_amd64.deb, *.x86_64.rpm |
The installer registers the
.mdfile association (double-click to open). The portable build runs without installing but won't change file associations. All builds require the system WebView (WebView2 is preinstalled on Windows 11).
This is open-source software and the exe is not code-signed yet, so Windows
Defender or SmartScreen may occasionally flag it as a "potentially unwanted
program (PUA)" such as Program:Win32/Wacapew.A!ml. This is a false positive,
not actual malware — the !ml suffix means it's a machine-learning heuristic
guess, not a signature match.
- Prefer the installer build — it tends to be flagged less often than the portable single-file exe.
- Every binary is built by GitHub Actions straight from public source. You can
verify any exe yourself on VirusTotal (a typical
false positive shows only a few of dozens of engines flagging it, all with
heuristic names like
!ml/PUA/Generic). - If blocked, choose Allow / Restore in the notification, or restore it under Windows Security → Virus & threat protection → Protection history.
The macOS build is not notarized by Apple yet, and recent macOS releases are increasingly strict, so the first launch may be blocked ("cannot be opened because the developer cannot be verified"). Use any one of these:
-
Right-click → Open (Ventura and earlier): right-click
Markdown Viewer.app→ Open → Open again. -
System Settings (Sonoma / Sequoia): after the first blocked attempt, go to System Settings → Privacy & Security and click Open Anyway.
-
Or run once in Terminal (clears the quarantine attribute):
xattr -cr "/Applications/Markdown Viewer.app"
You only need to do this once.
If you hit a blank window or libGLESv2.so.2: undefined symbol (common across
different GPU/driver/VM setups), the app already disables WebKitGTK's DMABUF
renderer to work around it. If problems persist, add one more env var at launch:
WEBKIT_DISABLE_COMPOSITING_MODE=1 ./Markdown.Viewer_*_amd64.AppImage(You can restore the default behaviour with WEBKIT_DISABLE_DMABUF_RENDERER=0.)
| Shortcut | Action |
|---|---|
Ctrl+O |
Open a file |
Ctrl+F |
Find in document |
Ctrl+E |
Toggle edit / preview |
Ctrl+S |
Save |
Ctrl+\ |
Toggle outline sidebar |
Ctrl++ / Ctrl+- |
Increase / decrease font size (or the A+ / A− buttons) |
md-viewer.exe file.md # open and render
md-viewer.exe file.md --edit # open straight into edit mode
md-viewer.exe file.md --zoom=1.5 # scale the whole UI (high-DPI / accessibility)npm install
npm run tauri devnpm run tauri buildOutput (Windows): src-tauri/target/release/md-viewer.exe plus NSIS/MSI
installers under src-tauri/target/release/bundle/.
Push a version tag and GitHub Actions builds Windows / macOS (Intel + Apple Silicon) / Linux installers — plus a portable Windows exe — and publishes them to a release:
git tag v1.0.0
git push origin v1.0.0
