Repository navigation
Markup Preview v0.7.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 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; 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.7.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.7.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.7.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.7.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.
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. 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.6.0...v0.7.0