Repository navigation
Markup Preview v0.10.0
Markup Preview is a live reader for local Org-mode and Markdown files. Keep writing in your editor and the preview follows your saves. Downloaded releases need no Node.js, npm, or Emacs.
Includes document tabs, offline Mermaid diagrams, local and HTTP/HTTPS images, an outline, search, source view, themes, zoom, and Org and GitHub-style Markdown formatting. Local document links open in tabs, including heading targets. Hugo metadata displays from Org headers and Markdown YAML/TOML front matter, with a Draft badge only when true. Documents stay local. Remote images load automatically and contact their hosts without cookies, authentication, or document referrers. Embedded HTML and Babel blocks never execute. BSD-3-Clause, with the MIT-licensed Orga parser.
Markup Preview v0.7.0 replaces the Org Preview name and keeps its original icon. This is a fresh application identity with default preferences. Remove the old app or Linux launcher manually after installing; existing settings are not migrated.
macOS: Apple Silicon
- Download
markup-preview-0.10.0-arm64.dmgandSHA256SUMS-darwin-arm64.txtfrom Assets below. The ZIP is an alternative; GitHub's Source code archives are not installers. - Quit older copies. Open the DMG, drag Markup Preview.app into Applications, and eject the disk image.
- Launch the Applications copy. If macOS cannot verify the developer and you trust this repository, first try opening the app, then use System Settings → Privacy & Security → Open Anyway and confirm Open. These builds are ad-hoc signed for bundle integrity, but not Developer-ID-signed or notarized. Click Done on the initial alert, then approve this app specifically; no paid Apple Developer membership is needed to run it.
- Click Open file, press ⌘O, drag in an Org or Markdown file, or use Finder → Open With → Markup Preview. Keep one installed copy.
Apple first-launch guidance. If the app is reported as damaged, re-download and verify its checksum; report the exact alert if it persists.
Omarchy / Arch Linux: x86_64
Download markup-preview-0.10.0.tar.gz and SHA256SUMS-linux-x64.txt to Downloads. This tested installation uses your home directory and needs no FUSE or sudo:
MARKUP_PREVIEW_VERSION=0.10.0
cd "$HOME/Downloads"
mkdir -p "$HOME/.local/opt" "$HOME/.local/bin"
tar -xzf "markup-preview-$MARKUP_PREVIEW_VERSION.tar.gz" -C "$HOME/.local/opt"
ln -sfn "$HOME/.local/opt/markup-preview-$MARKUP_PREVIEW_VERSION/markup-preview" "$HOME/.local/bin/markup-preview"
"$HOME/.local/bin/markup-preview"Use Open file, Ctrl+O, or drag-and-drop. Open notebooks from the terminal with ~/.local/bin/markup-preview ~/notes/today.org. The installation guide includes an optional app-launcher entry, default file associations, and update instructions. No AUR/pacman package is supplied.
Alternatively download markup-preview-0.10.0.AppImage, make it executable, and run it with --appimage-extract-and-run when FUSE 2 is absent. Native Wayland and XWayland were tested on Omarchy. Run as your normal user with sandboxing enabled.
Compare downloads with the supplied SHA-256 files using shasum -a 256 on macOS or sha256sum on Linux. To update, quit the app and repeat installation for the new version; there is no in-app updater.
Windows 11: Intel/AMD x64
Download markup-preview-0.10.0-win-x64-setup.exe and SHA256SUMS-win32-x64.txt. Compare the installer hash using PowerShell Get-FileHash .\markup-preview-0.10.0-win-x64-setup.exe -Algorithm SHA256 with the checksum file.
Run the installer as your normal user, then open Markup Preview from Start. No Node.js, npm, or administrator access is needed. Use Open file, Ctrl+O, drag-and-drop, or Explorer → Open with. Choose default file handlers yourself in Windows Settings.
The Windows installer is unsigned. Windows may show SmartScreen or unknown-publisher warnings. Verify the download and only proceed if you trust this release; do not disable Windows security protections. Managed devices may require administrator approval.
To update, quit the app and run the newer installer. To uninstall, use Settings → Apps → Installed apps → Markup Preview. Preferences and your documents are preserved. Native ARM64 builds are not supplied. See the Windows installation guide for commands and details.
Known limits
Up to 20 UTF-8 documents, 16 MiB per file and 64 MiB of source files total. Tabs do not persist after quitting. Network-share, device, and Windows drive-relative paths are unsupported. Images share limits of 100 references, 8 MiB per image, and 32 MiB per document; remote downloads allow five redirects and time out after 15 seconds. Failed images show placeholders. Mermaid rendering has input, output, and time limits; document configuration and remote assets are unsupported. Editing, full Emacs export parity, unsupported local file types, math, other diagram engines, Babel, Quick Look, Developer ID signing/notarization, and auto-updates remain outside scope. Intel Mac builds are not supplied.
Release information · Merged source
What's Changed
Full Changelog: v0.9.0...v0.10.0