Installation

MarkText is a free, open-source Markdown editor for Linux, macOS and Windows. Pre-built binaries are published with every release on GitHub releases. Pick the one that matches your platform.

Windows

Artifact	When to choose
`marktext-win-x64-<version>-setup.exe`	Recommended. NSIS installer; per-user install, lets you pick the install directory, creates Start Menu and Desktop shortcuts.
`marktext-win-x64-<version>.zip`	Portable zip. Extract anywhere and run `marktext.exe`. See Portable mode for details on keeping your data alongside the app.

After installing, MarkText registers itself as a handler for .md, .markdown, .mmd, .mdown, .mdtxt and .mdtext files.

macOS

Artifact	When to choose
`marktext-mac-arm64-<version>.dmg`	Apple Silicon (M1 / M2 / M3 / M4).
`marktext-mac-x64-<version>.dmg`	Intel Macs.
`marktext-mac-<arch>-<version>.zip`	Plain zip alternative to the DMG.

Open the DMG and drag MarkText into your Applications folder. Builds are not currently notarized, so the first launch may prompt the system Gatekeeper — right-click the app and choose Open to accept it once.

You can also install via Homebrew Cask:

brew install --cask mark-text

Linux

MarkText is shipped in five Linux formats. Most users want the AppImage.

Artifact	When to choose
`marktext-linux-<version>.AppImage`	Recommended. Runs on most distros without root. `chmod +x` and double-click (or run directly).
`marktext-linux-<version>.deb`	Debian, Ubuntu, Linux Mint, Pop!_OS, … (`sudo apt install ./marktext-linux-<version>.deb`).
`marktext-linux-<version>.rpm`	Fedora, RHEL, openSUSE, … (`sudo rpm -i marktext-linux-<version>.rpm`).
`marktext-linux-<version>.snap`	Ubuntu / any snap-enabled distro (`sudo snap install marktext-linux-<version>.snap --dangerous --classic`).
`marktext-linux-<version>.tar.gz`	Portable tarball. Extract and run the included `marktext` binary.

Arch Linux users can install MarkText from the AUR (marktext-bin).

[!NOTE] See Linux notes for distro-specific tips (sandbox flags, font configuration, file-association quirks).

Verify the download

Every release contains a latest-<platform>.yml file with SHA-512 hashes. To verify:

# Example on macOS / Linux
shasum -a 512 marktext-linux-<version>.AppImage

Compare the value to the entry in latest-linux.yml on the release page.

Build from source

If you'd rather build from source — for example to track develop, to run on an architecture we don't publish a binary for, or to contribute — see the Build instructions in the developer docs. A minimal recap:

git clone https://github.com/marktext/marktext.git
cd marktext
pnpm install
pnpm run build

Output installers land in the repository's dist/ folder.

Updating

MarkText checks for updates on launch (this can be disabled under Preferences → General → Updates). When an update is published, the app downloads it in the background and installs on next restart.

Portable installs and the AppImage do not auto-update — re-download the latest artifact when you want to upgrade.

Uninstall

Platform	How
Windows	Settings → Apps, or run the bundled `Uninstall MarkText.exe`.
macOS	Drag MarkText.app to the Trash. Optionally also remove `~/Library/Application Support/marktext`.
Linux (.deb)	`sudo apt remove marktext`
Linux (.rpm)	`sudo rpm -e marktext`
Linux (snap)	`sudo snap remove marktext`
Linux (AppImage / tar.gz)	Delete the file you extracted.

To wipe MarkText's user data as well, remove its application data directory.