.github/workflows | ||
ui | ||
.gitignore | ||
.goreleaser.yml | ||
console_windows.go | ||
example.png | ||
github.go | ||
gitlab.go | ||
glow_test.go | ||
go.mod | ||
go.sum | ||
LICENSE | ||
main.go | ||
Makefile | ||
README.md | ||
stash.go |
Glow
Render markdown on the CLI, with pizzazz!
Installation
Use your fave package manager:
# macOS or Linux
brew install glow
# Arch Linux (btw)
yay -S glow
# Void Linux
xbps-install -S glow
# Nix
nix-env -iA nixpkgs.glow
# FreeBSD
pkg install glow
Or download a binary from the releases page. MacOS, Linux, FreeBSD binaries are available, as well as Debian and RPM packages. ARM builds are also available for Linux and FreeBSD.
Or just use go get
:
go get github.com/charmbracelet/glow
Usage
Use a markdown source as the primary argument:
# Read from file
glow README.md
# Read from stdin
glow -
# Fetch README from GitHub / GitLab
glow github.com/charmbracelet/glow
# Fetch markdown from HTTP
glow https://host.tld/file.md
When glow
is started without a markdown source, it will try to find a
README.md
or README
file in the current working directory.
Word Wrapping
The -w
flag lets you set a maximum width at which the output will be wrapped:
glow -w 60
Paging
The output can be displayed in the user's preferred pager with the -p
flag.
This defaults to the ANSI-aware less -r
if $PAGER
is not explicitly set.
Styles
You can choose a style with the -s
flag. When no flag is provided glow
tries
to detect your terminal's current background color and automatically picks
either the dark
or the light
style for you.
glow -s [dark|light]
Alternatively you can also supply a custom JSON stylesheet:
glow -s mystyle.json
Check out the Glamour Style Section to find more styles. Or make your own!
For additional usage details see:
glow --help
License
Part of Charm.
Charm热爱开源!