.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. Windows, MacOS, and Linux (including ARM) binaries are available, as well as Debian and RPM packages.
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热爱开源!