如何快速安装 leaf 终端 Markdown 预览器macOS、Linux、Windows、Android 多平台一键安装指南与验证清单【免费下载链接】leafTerminal Markdown previewer — GUI-like experience.项目地址: https://gitcode.com/gh_mirrors/leaf37/leafleaf 是一款运行在终端里的Markdown 预览器用纯终端界面提供接近 GUI 的浏览体验语法高亮、表格、LaTeX 公式、Mermaid 图、TOC 侧边栏一应俱全。本指南带你用最少的命令在macOS、Linux、Windows、Android四大平台完成一键安装并通过一份验证清单确认 leaf 已就绪。为什么选 leaf终端里的 Markdown 预览器相比浏览器渲染leaf 直接在终端中打开.md文件无需启动任何图形程序实时预览watch 模式在文件保存后自动重载文件选择器模糊搜索 目录浏览器不用切窗口富渲染表格、代码高亮、LaTeX、Mermaid 图、可点击链接轻量集成支持 stdin 管道、fzf 预览、Shell 补全一键安装 leafmacOS、Linux、Android 通用命令一条命令即可完成 macOS、Linux、AndroidTermux平台的安装。安装脚本会自动识别你的系统与 CPU 架构、下载对应二进制并先做SHA256 校验再落盘源码见 scripts/install.shcurl -fsSL https://raw.githubusercontent.com/RivoLink/leaf/main/scripts/install.sh | sh安装细节平台安装位置说明macOSIntel / Apple Silicon~/.local/bin/leaf架构自动识别Linuxx64 / arm64~/.local/bin/leaf架构自动识别Android / Termux~/.local/bin/leaf自动识别 Android 环境 若终端提示leaf: command not found说明~/.local/bin不在 PATH 中脚本会打印相应提示把它加入 PATH 后重开终端即可。Windows 一键安装 leafPowerShell 命令在 PowerShell 中运行下面这条命令脚本会自动把%LOCALAPPDATA%\Programs\leaf加入用户 PATH无需手动配置源码见 scripts/install.ps1irm https://raw.githubusercontent.com/RivoLink/leaf/main/scripts/install.ps1 | iex⚠️ 若 Windows 提示缺少Visual C 运行库请从微软官网安装最新版 Visual C RedistributableX64 版再重新运行leaf。更多 leaf 安装方式npm、Homebrew、Cargo、Scoop如果你已习惯包管理器也可以走官方包通道npm 包的各平台二进制见 npm/package.json方式命令npmnpm install -g rivolink/leafHomebrewbrew install leaf-markdown-viewerCargocargo install leaf-markdown-viewerScoopWindowsscoop install leaf-markdown-viewerAURArchLinuxyay -S leaf-markdown-viewer任选其一即可无需重复安装。安装后验证清单3 步确认 leaf 安装成功安装完成后按顺序执行以下检查全部通过即表示安装成功版本检查运行leaf --version能看到版本号输出打开文件对任意 Markdown 文件运行leaf 文件名.md能看到带主题色的渲染界面TOC 侧边栏在预览界面按t右侧出现目录侧边栏按1-9可跳转到对应标题# 第 1 步验证版本 leaf --version # 第 2 步打开一个 Markdown 文件试试仓库自带的 TESTING.md leaf TESTING.md # 第 3 步可选为当前 Shell 开启 Tab 补全 leaf --auto-complete补全支持 bash、zsh、fish、Nushell、PowerShell脚本位于 completions/重启终端后生效。leaf 更新与卸载命令速查leaf 内置自更新会下载对应资产并核对官方checksums.txt中的 SHA256leaf --update # 一键更新到最新发布版各包管理器更新npm update -g rivolink/leaf、brew upgrade leaf-markdown-viewer、scoop update leaf-markdown-viewer。卸载时建议先清掉配置与补全再移除二进制leaf --config remove # 删除配置目录 leaf --auto-complete remove # 移除 Shell 补全 # 之后执行 npm uninstall / brew uninstall / cargo uninstall / scoop uninstall交互式卸载脚本见 scripts/uninstall.sh 与 scripts/uninstall.ps1。常见安装问题排查现象原因与解决Windows 下leaf.exe无法启动缺少 Visual C 运行库安装最新版 VC Redistributable (X64)leaf --update报错文件被占用关闭所有正在运行 leaf 的终端重跑 PowerShell 安装命令leaf --auto-complete报脚本被禁用执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser后重开 PowerShellmacOS/Linux 提示找不到命令将~/.local/bin加入 PATH 后重开终端第一次打开 leaf 的完整体验安装验证通过后推荐按这个顺序体验演示源文件在 demo/README.mdleaf 文件名.md打开文件j/k滚动、g/G跳首尾按t打开 TOC按ShiftT切换主题Arctic、Forest、Ocean Dark、Solarized Dark按CtrlE直接在你配置的外部编辑器中打开当前文件leaf --watch 文件名.md开启 watch 模式边写边看核心文件速查内容路径完整安装 / 更新 / 卸载文档README.mdLinux/macOS/Android 安装脚本scripts/install.shWindows 安装脚本scripts/install.ps1默认配置项说明config.toml主题示例自定义配色gruvbox.tomlnpm 包定义npm/package.json功能演示与截图demo/README.md至此你已经完成了 leaf 终端 Markdown 预览器的多平台安装与验证。接下来只需leaf --config打开配置文件设置默认主题与编辑器即可把 leaf 融入日常写作与 AI 工作流。【免费下载链接】leafTerminal Markdown previewer — GUI-like experience.项目地址: https://gitcode.com/gh_mirrors/leaf37/leaf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考