下面是一份完整的 MarkText 手动安装笔记，基于你刚才的实战操作整理而成。所有命令可直接复制粘贴（注意替换用户名或路径）。

---

MarkText 安装笔记（AppImage 解包版）

安装环境

• 系统：Linux（GNOME / KDE 等桌面环境）
• 安装目录：~/.local/opt/marktext
• 可执行文件：解包后的 marktext 二进制（绕过 AppRun 脚本）
• 终端命令：软链接至 ~/.local/bin/marktext
• 应用菜单：~/.local/share/applications/marktext.desktop

---

1. 下载 AppImage

cd ~/Downloads/
wget https://github.com/marktext/marktext/releases/download/v0.19.1/marktext-linux-0.19.1.AppImage

---

2. 解包（提取文件系统）

cd ~/Downloads/
./marktext-linux-0.19.1.AppImage --appimage-extract

解压后生成 squashfs-root 文件夹。

---

3. 部署到本地目录

# 删除旧版本（如果存在）
rm -rf ~/.local/opt/marktext
# 移动并重命名
mv squashfs-root ~/.local/opt/marktext

---

4. 创建终端软链接（直接指向二进制，跳过 AppRun）

ln -s ~/.local/opt/marktext/marktext ~/.local/bin/marktext

确保 ~/.local/bin 已加入 PATH（通常在 ~/.bashrc 或 ~/.profile 中添加 export PATH="$HOME/.local/bin:$PATH"）。

---

5. 配置应用菜单（.desktop 文件）

5.1 复制自带 .desktop 模板

cp ~/.local/opt/marktext/marktext.desktop ~/.local/share/applications/

5.2 编辑 ~/.local/share/applications/marktext.desktop

用你喜欢的编辑器（如 nvim、nano）修改内容，确保以下字段正确：

[Desktop Entry]
Name=marktext
Exec=/home/sssc/.local/opt/marktext/marktext  --no-sandbox %U
Terminal=false
Type=Application
Icon=/home/sssc/.local/opt/marktext/resources/icons/icon.ico
StartupWMClass=marktext
X-AppImage-Version=0.19.1
Keywords=marktext;
Comment=一款简洁优雅的开源Markdown编辑器，专注于速度与易用性。
MimeType=text/markdown;
Categories=Office;TextEditor;Utility;

关键字段说明：

• Exec：必须使用绝对路径，直接指向二进制文件（不是 AppRun），带上 --no-sandbox 和 %U。
• Icon：使用绝对路径指向解包目录内的图标文件（检查实际文件名，可能是 marktext.png 或 icon.png）。
• StartupWMClass：需用 xprop WM_CLASS 获取窗口类名（一般为 marktext），确保任务栏图标正确。
• MimeType：可简化为 text/markdown;，系统会自动关联 .md 文件。

5.3 刷新桌面数据库

update-desktop-database ~/.local/share/applications/

---

6. 生效与验证

• 注销并重新登录（或按 Alt+F2，输入 r 重启 GNOME Shell）以刷新图标缓存。
• 在终端输入 marktext 启动，或在应用菜单（Super 键）搜索 MarkText 点击启动。
• 检查任务栏图标是否正常（如仍显示齿轮，检查 StartupWMClass 和 Icon 路径）。

---

附：常用维护命令

• 卸载：

  rm -rf ~/.local/opt/marktext
  rm ~/.local/bin/marktext
  rm ~/.local/share/applications/marktext.desktop
  update-desktop-database ~/.local/share/applications/
  

• 更新：下载新版本 AppImage，重复步骤 2~5（无需删除旧配置，rm -rf ~/.local/opt/marktext 会清空旧程序）。

---

注意事项

• 每次重新解包后，.desktop 文件中的 Exec= 和 Icon= 路径可能需要重新调整为绝对路径，建议保留备份模板。
• 若 ~/.local/bin 不在 PATH 中，终端无法识别 marktext 命令，请检查环境变量配置。
• 若启动时提示沙箱错误，请保留 --no-sandbox 参数。

---

这份笔记已涵盖你所有操作步骤，并修正了复制 .desktop 的命令错误。以后重装或换机器，按此流程即可快速部署。 🚀