提升命令行体验，Glow让Markdown更美丽✨

4个月前发布

0150

Glow – 终端中的高效Markdown阅读器

在如今这个以代码为主的时代，Markdown作为一种轻量级标记语言，越来越受到开发者们的青睐。而Glow就是一个为终端用户量身定制的Markdown阅读工具，旨在将Markdown文件的美丽与力量带给CLI（命令行界面）用户。

什么是Glow？

Glow是一个基于终端的Markdown阅读器，设计初衷是为了在命令行中优雅地呈现Markdown文件。它可以帮助你快速查找本地的Markdown文件，并直接在命令行上阅读文档，无论你是在某个目录下，还是在一个Git版本库中，Glow都会主动进行搜索。

安装Glow

Glow的安装非常简单，支持多种平台，包括macOS、Linux、Windows等。以下是一些主流平台的安装方式：

macOS或Linux用户

通过Homebrew进行安装：


brew install glow

对于使用MacPorts的用户：


sudo port install glow

对于Arch Linux用户：


pacman -S glow

对于其它几种Linux发行版的安装：

Void Linux:


xbps-install -S glow

Nix:


nix-shell -p glow --command glow

FreeBSD:


pkg install glow

Solus:


eopkg install glow

以及Debian/Ubuntu：


sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/ * *" | sudo tee /etc/apt/sources.list.d/charm.list
sudo apt update && sudo apt install glow

Fedora/RHEL:


echo '[charm]
name=Charm
baseurl=https://repo.charm.sh/yum/
enabled=1
gpgcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repo
sudo yum install glow

Windows用户

也可以通过Chocolatey、Scoop或Winget来安装：


choco install glow


scoop install glow


winget install charmbracelet.glow

Android用户

如果你是Termux用户，可以通过以下命令安装Glow：


pkg install glow

Go用户

对于熟悉Go的用户，可以通过Go工具直接安装：


go install github.com/charmbracelet/glow/v2@latest

从源代码构建

如果你想自行构建Glow，可以使用以下命令：


git clone https://github.com/charmbracelet/glow.git
cd glow
go build

使用Glow

使用Glow非常简单。只需在终端中输入glow并按回车，你就可以启动文本用户界面（TUI），并浏览当前目录及其子目录中的Markdown文件。如果你正在使用一个Git版本库，Glow会自动搜索其中的Markdown文件。

基本用法

你可以通过命令行读取Markdown文件：


# 从文件读取
glow README.md

# 从标准输入读取
echo "[Glow](https://github.com/charmbracelet/glow)" | glow -

从互联网获取Markdown文件

Glow不仅支持本地文件读取，还可以直接从GitHub或GitLab等平台获取文档：


glow github.com/charmbracelet/glow

或者从HTTP链接加载Markdown文件：


glow https://host.tld/file.md

额外功能

单词换行

使用-w标志可以设置输出的最大宽度：


glow -w 60

分页功能

CLI输出可以选择使用你偏好的分页器，使用-p标志进行设置。如果没有显式设置，Glow默认会使用ANSI-aware的less -r。

样式选择

Glow允许用户通过-s标志来选择样式。当没有传入标志时，Glow会自动检测你的终端背景色并选择黑暗或光亮样式。


glow -s [dark|light]

此外，你还可以提供一个自定义的JSON样式文件：


glow -s mystyle.json

如果想了解更多用法，可以使用以下命令查看帮助信息：


glow --help

详细的样式和自定义选项，可以参考Glamour Style Section。

配置文件

如果你经常使用相同的标志调用Glow，建议创建一个配置文件。运行glow config会在你指定的编辑器中打开配置文件。你也可以手动在默认配置路径创建一个名为glow.yml的文件。示例配置如下：


style: "light"  # 样式名称或JSON路径（默认为"auto"）
mouse: true      # 支持鼠标滚轮（仅在TUI模式下）
pager: true      # 使用分页器显示Markdown
width: 80        # 设置换行的列数
all: false       # 显示所有文件，包括隐藏和忽略的
showLineNumbers: false  # 显示行号（仅在TUI模式下）
preserveNewLines: false  # 保留输出中的换行符