Repository navigation
Important
macOS and Linux installers are the main v3.10.6 milestone. These are complete desktop applications with editing, Preview, exports, linked files, and persistent Vault storage. No Node.js, npm, developer tools, or adjacent resource folder is required.
Choose your desktop download
Desktop downloads
Choose a native installer for the easiest setup. On Ubuntu/Debian, DEB is recommended because it installs required dependencies; the Linux .tar.gz archives are optional portable builds for systems that already have the necessary runtime libraries.
| Platform | CPU architecture | Download | Works with | Published size | Application screenshot |
|---|---|---|---|---|---|
| macOS | Apple Silicon (M1 and later) | Apple Silicon DMG | Native ARM64; macOS 11+ dependency baseline | 6.23 MiB |
Markdown Viewer on macOS |
| Intel x64 | Intel DMG | Intel Macs and Intel/AMD-hosted macOS VMs; macOS 10.15+ dependency baseline | 6.30 MiB | ||
| Universal | Universal DMG | One package containing Intel and Apple Silicon slices | 11.24 MiB | ||
| Windows | x64 | Windows EXE | Windows 10 and 11 | 17.32 MiB |
Markdown Viewer on Windows |
| Ubuntu / Debian | amd64 / x64 | amd64 DEB (recommended) | Intel and AMD PCs; Ubuntu 22.04/24.04 package validation | 2.93 MiB |
Markdown Viewer on Ubuntu / Debian |
| ARM64 | ARM64 DEB (recommended) | 64-bit ARM Linux | 2.94 MiB | ||
| ARMHF | ARMHF DEB (recommended) | 32-bit ARM Linux | 2.93 MiB | ||
| amd64 / x64 | x64 tar.gz (portable) | Intel/AMD Linux systems with runtime libraries already installed | 4.09 MiB | ||
| ARM64 | ARM64 tar.gz (portable) | 64-bit ARM Linux with runtime libraries already installed | 4.11 MiB | ||
| ARMHF | ARMHF tar.gz (portable) | 32-bit ARM Linux with runtime libraries already installed | 4.07 MiB |
Sizes are the published asset sizes in MiB (1 MiB = 1,048,576 bytes).
Note for portable Linux builds: .tar.gz archives preserve executable permissions but do not install WebKitGTK, GTK, tray libraries, desktop entries, or icons. Use the appropriate DEB unless you manage those dependencies separately.
Installation guide
macOS
- Open the architecture-matching DMG.
- Drag Markdown Viewer.app to Applications.
- Eject the disk image and open the installed application.
- Allow Documents access when prompted so the app can use its Vault.
Install the newest Safari/WebKit update offered for the Mac; Catalina should use Safari 15.6.1. The version numbers above are native build baselines, not a guarantee of full UI acceptance on every older macOS release. CI launches the installed packages on Intel and Apple Silicon macOS 15 and 26.
This release is locally (ad-hoc) signed, not Apple Developer ID-signed or notarized. Read MACOS-SIGNING.txt for the exact record. Use the per-app Open Anyway flow only for a build you trust; never disable Gatekeeper globally.
Ubuntu / Debian
Open the .deb with Software Install, or install from a terminal:
sudo apt install ./markdown-viewer-linux_amd64.debReplace amd64 with arm64 or armhf when needed. The DEB configures executable permissions, dependencies, the application launcher, icons, and AppStream metadata.
Windows
Run markdown-viewer-win_x64.exe. Windows SmartScreen can warn for an unsigned or reputation-new executable. Review the publisher, source, and SHA-256 checksum before choosing More info → Run anyway.
What's Changed
- feat(desktop): add native file handling and Explorer improvements by @Kechos23 in #269
- fix(preview): preserve document scroll through loading and view changes by @ThisIs-Developer in #286
- fix(pdf): preserve page content and clarify selectable export by @ThisIs-Developer in #287
- fix(clipboard): preserve rich-text formatting on paste by @alainpaulinn in #284
- feat(desktop): add branded Mac and Ubuntu installers by @ThisIs-Developer in #289
New Contributors
- @alainpaulinn made their first contribution in #284
Full Changelog: v3.10.5...v3.10.6


