ContextQMD
Back to Marktext

Linux Installation Instructions

docs/end-user/LINUX.md

0.19.02.5 KB
Original Source

Linux Installation Instructions

AppImage

Download the AppImage and type the following:

  1. chmod +x marktext-%version%-x86_64.AppImage
  2. ./marktext-%version%-x86_64.AppImage
  3. Now you can execute MarkText.

Installation

You cannot really install an AppImage. It's a file which can run directly after getting executable permission. To integrate it into desktop environment, you can either create desktop entry manually or use AppImageLauncher.

Desktop file creation

See example desktop file.

bash
$ curl -L https://raw.githubusercontent.com/marktext/marktext/develop/resources/linux/marktext.desktop -o $HOME/.local/share/applications/marktext.desktop

# Update the Exec in desktop file to your real marktext command. Specify Path if necessary.
$ vim $HOME/.local/share/applications/marktext.desktop

$ update-desktop-database $HOME/.local/share/applications/

AppImageLauncher integration

You can integrate the AppImage into the system via AppImageLauncher. It will handle the desktop entry automatically.

Uninstallation

  1. Delete AppImage file.
  2. Delete your desktop file if exists.
  3. Delete your user settings: ~/.config/marktext

Custom launch script

  1. Save AppImage somewhere. Let's say ~/bin/marktext.AppImage

  2. chmod +x ~/bin/marktext.AppImage

  3. Create a launch script:

    sh
    #!/bin/bash
DESKTOPINTEGRATION=0 ~/bin/marktext.AppImage

Known issues

  • MarkText is always integrated into desktop environment after updating

Binary

You can download the latest marktext-%version%.tar.gz package from the release page. You may need to install electron dependencies.

Arch User Repository

MarkText is available on the AUR as marktext-bin and will automatically install the dependencies: glibc, gtk3, nss, alsa-lib, libxss, cups, libxkbcommon, libxkbfile, mesa, and hicolor-icon-theme.

Install it via an AUR helper like yay -S marktext-bin or with

bash
git clone https://aur.archlinux.org/marktext.git
cd marktext-bin
makepkg -si

Note: The AUR package is not maintained by the maintainer of this repository and may be out of date. Take note of the version numbers and modify the PKGBUILD on the AUR as necessary before installation or update.