安装

Markon 提供桌面应用（GUI）和命令行（CLI）两种形态。

桌面版

macOS

通过 Homebrew 安装（推荐）

brew tap kookyleo/markon https://github.com/kookyleo/markon
brew install --cask markon

后续升级：

brew upgrade --cask markon

首次启动仍会遇到下面说的 Gatekeeper 提示 —— brew 本身只校验下载完整性，不管签名类型。想完全跳过提示，安装时加 --no-quarantine：

brew install --cask --no-quarantine markon

手动下载安装

• Apple SiliconMarkon_0.15.19_aarch64.dmg19.7 MB
• IntelMarkon_0.15.19_x64.dmg21.1 MB

下载对应芯片的 .dmg，双击挂载后拖到 Applications 目录。

首次启动时，macOS Gatekeeper 会拒绝打开（因为应用使用的是 ad-hoc 签名，而非 Apple 颁发的证书）。打开 系统设置 → 隐私与安全性，滚动到下方 Security 区，点击 「Markon」 was blocked to protect your Mac 旁的 Open Anyway；再次确认即可。之后启动不会再提示。

较老版本 macOS（Monterey 及更早）

如果系统设置中没有「Open Anyway」按钮，请改用右键方式：在 Finder 的 Applications 目录中，右键（或 Control+点击）Markon.app → 选择 Open，弹出的确认框中再点 Open 即可放行。

Windows

• x64Markon_0.15.19_x64-setup.exe16.3 MB
• ARM64Markon_0.15.19_arm64-setup.exe15.0 MB

下载对应 CPU 的 -setup.exe，双击运行安装。

NSIS 安装包未做代码签名，会触发 SmartScreen。在「Windows protected your PC」弹窗中点左下角 More info，展开后点右下角 Run anyway 即可。

通过 Scoop 安装

如果你已经安装了 Scoop：

scoop bucket add kookyleo https://github.com/kookyleo/markon
scoop install kookyleo/markon

没装过 Scoop 的话，一行 PowerShell 即可：

irm get.scoop.sh | iex

（首次可能需要先 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser）

Linux

• AppImage · amd64Markon_0.15.19_amd64.AppImage95.4 MB
• AppImage · arm64Markon_0.15.19_arm64.AppImage92.2 MB
• deb · amd64Markon_0.15.19_amd64.deb23.0 MB
• deb · arm64Markon_0.15.19_arm64.deb21.5 MB

下载 .deb 后安装：

sudo dpkg -i Markon_*.deb

或下载 .AppImage 直接运行：

chmod +x Markon_*.AppImage
./Markon_*.AppImage

自动更新

桌面版启动后会定时检查更新。在 全局设置 → 更新通道 可选择：

• 正式版 — 仅接收通过 7 天验证期的稳定版（默认）
• 候选版 — 同时接收 RC 预览版，尝鲜新功能

CLI 版

Cargo（推荐）

cargo install markon markond

这会从 crates.io 安装两个二进制到 ~/.cargo/bin/：

• markon — CLI 与本地控制客户端；
• markond — 长期运行的后台服务。

两者都应在 PATH。缺少 markond 时，CLI 会退回前台服务模式，当前终端会被服务占用。

从源码

git clone https://github.com/kookyleo/markon.git
cd markon
cargo install --path crates/markond
cargo install --path crates/cli

从 GitHub Releases

桌面版已经随附后台服务，无需另行安装。若要在服务器或纯命令行环境中使用，请通过 Cargo 安装 markon 与 markond；也可以从 Releases 获取预编译的 CLI 文件（如有发布）。

验证安装

markon --version
command -v markond

markond 只由桌面端或 CLI 以临时配置启动，不需要日常手动调用。

卸载

桌面版：

• macOS：把 /Applications/Markon.app 扔进废纸篓
• Windows：控制面板 → 卸载程序
• Linux：sudo dpkg -r markon（deb）或删除 AppImage 文件

CLI 版：

cargo uninstall markon markond

用户数据统一存放在用户主目录下的 .markon/：

• macOS / Linux：~/.markon/
• Windows：%USERPROFILE%\.markon\

目录内主要文件：

• settings.json — GUI 偏好与工作区列表
• annotation.sqlite — 个人/共享批注、已读状态与对话数据库（可被 MARKON_SQLITE_PATH 覆盖）

这些文件卸载时不会自动删除，如需清理请手动移除。