企业官网建设流程全解析

如何快速安装 leaf 终端 Markdown 预览器：macOS、Linux、Windows、Android 多平台一键安装指南与验证清单

【免费下载链接】leafTerminal Markdown previewer — GUI-like experience.项目地址: https://gitcode.com/gh_mirrors/leaf37/leaf

leaf 是一款运行在终端里的Markdown 预览器，用纯终端界面提供接近 GUI 的浏览体验：语法高亮、表格、LaTeX 公式、Mermaid 图、TOC 侧边栏一应俱全。本指南带你用最少的命令，在macOS、Linux、Windows、Android四大平台完成一键安装，并通过一份验证清单确认 leaf 已就绪。

为什么选 leaf：终端里的 Markdown 预览器

相比浏览器渲染，leaf 直接在终端中打开.md文件，无需启动任何图形程序：

• 实时预览：watch 模式在文件保存后自动重载
• 文件选择器：模糊搜索 + 目录浏览器，不用切窗口
• 富渲染：表格、代码高亮、LaTeX、Mermaid 图、可点击链接
• 轻量集成：支持 stdin 管道、fzf 预览、Shell 补全

一键安装 leaf：macOS、Linux、Android 通用命令

一条命令即可完成 macOS、Linux、Android（Termux）平台的安装。安装脚本会自动识别你的系统与 CPU 架构、下载对应二进制，并先做SHA256 校验再落盘（源码见 scripts/install.sh）：

curl -fsSL https://raw.githubusercontent.com/RivoLink/leaf/main/scripts/install.sh | sh

安装细节：

💡 若终端提示leaf: command not found，说明~/.local/bin不在 PATH 中，脚本会打印相应提示，把它加入 PATH 后重开终端即可。

Windows 一键安装 leaf：PowerShell 命令

在 PowerShell 中运行下面这条命令，脚本会自动把%LOCALAPPDATA%\Programs\leaf加入用户 PATH，无需手动配置（源码见 scripts/install.ps1）：

irm https://raw.githubusercontent.com/RivoLink/leaf/main/scripts/install.ps1 | iex

⚠️ 若 Windows 提示缺少Visual C++ 运行库，请从微软官网安装最新版 Visual C++ Redistributable（X64 版），再重新运行leaf。

更多 leaf 安装方式：npm、Homebrew、Cargo、Scoop

如果你已习惯包管理器，也可以走官方包通道（npm 包的各平台二进制见 npm/package.json）：

任选其一即可，无需重复安装。

安装后验证清单：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中的 SHA256：

leaf --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。

常见安装问题排查

第一次打开 leaf 的完整体验

安装验证通过后，推荐按这个顺序体验（演示源文件在 demo/README.md）：

1. leaf 文件名.md打开文件，j/k滚动、g/G跳首尾
2. 按t打开 TOC，按Shift+T切换主题（Arctic、Forest、Ocean Dark、Solarized Dark）
3. 按Ctrl+E直接在你配置的外部编辑器中打开当前文件
4. leaf --watch 文件名.md开启 watch 模式，边写边看

核心文件速查

至此，你已经完成了 leaf 终端 Markdown 预览器的多平台安装与验证。接下来只需leaf --config打开配置文件，设置默认主题与编辑器，即可把 leaf 融入日常写作与 AI 工作流。

【免费下载链接】leafTerminal Markdown previewer — GUI-like experience.项目地址: https://gitcode.com/gh_mirrors/leaf37/leaf