Installation#
Inkiva 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 |
|---|---|
inkiva-win-x64-<version>-setup.exe | Recommended. NSIS installer; per-user install, lets you pick the install directory, creates Start Menu and Desktop shortcuts. |
inkiva-win-x64-<version>.zip | Portable zip. Extract anywhere and run inkiva.exe. See Portable mode for details on keeping your data alongside the app. |
After installing, Inkiva registers itself as a handler for .md, .markdown, .mmd, .mdown, .mdtxt and .mdtext files.
macOS#
| Artifact | When to choose |
|---|---|
inkiva-mac-arm64-<version>.dmg | Apple Silicon (M1 / M2 / M3 / M4). |
inkiva-mac-x64-<version>.dmg | Intel Macs. |
inkiva-mac-<arch>-<version>.zip | Plain zip alternative to the DMG. |
Open the DMG and drag Inkiva 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 inkivaLinux#
Inkiva is shipped in five Linux formats. Most users want the AppImage.
| Artifact | When to choose |
|---|---|
inkiva-linux-<version>.AppImage | Recommended. Runs on most distros without root. chmod +x and double-click (or run directly). |
inkiva-linux-<version>.deb | Debian, Ubuntu, Linux Mint, Pop!_OS, … (sudo apt install ./inkiva-linux-<version>.deb). |
inkiva-linux-<version>.rpm | Fedora, RHEL, openSUSE, … (sudo rpm -i inkiva-linux-<version>.rpm). |
inkiva-linux-<version>.snap | Ubuntu / any snap-enabled distro (sudo snap install inkiva-linux-<version>.snap --dangerous --classic). |
inkiva-linux-<version>.tar.gz | Portable tarball. Extract and run the included inkiva binary. |
Arch Linux users can install Inkiva from the AUR (inkiva-bin).
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 inkiva-linux-<version>.AppImageCompare 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/Bulls1986/Inkiva.git
cd inkiva
pnpm install
pnpm run buildOutput installers land in the repository's dist/ folder.
Updating#
Inkiva 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 Inkiva.exe. |
| macOS | Drag Inkiva.app to the Trash. Optionally also remove ~/Library/Application Support/inkiva. |
| Linux (.deb) | sudo apt remove inkiva |
| Linux (.rpm) | sudo rpm -e inkiva |
| Linux (snap) | sudo snap remove inkiva |
| Linux (AppImage / tar.gz) | Delete the file you extracted. |
To wipe Inkiva's user data as well, remove its application data directory.