No description
Find a file
2020-10-05 13:54:01 +02:00
.github/workflows Add Go 1.15.x to build matrix 2020-10-05 13:52:36 +02:00
ui Apply fine-grained spinner display rules to file listing view 2020-10-05 13:54:01 +02:00
.gitignore Rename to glow 2019-12-20 22:47:47 +01:00
.golangci.yml Add golangci config 2020-10-05 13:53:26 +02:00
.goreleaser.yml Update deprecated homebrew tap section in goreleaser config 2020-10-05 13:52:51 +02:00
console_windows.go Enable ANSI for Windows consoles 2020-01-09 11:38:09 +01:00
example.png Update example image with unicode characters 2020-01-13 12:21:08 -05:00
github.go Make source private 2020-03-31 08:53:35 +02:00
gitlab.go Make source private 2020-03-31 08:53:35 +02:00
glow_test.go Fix tests (don't test glow with no arguments) 2020-10-05 13:45:22 +02:00
go.mod Apply fine-grained spinner display rules to file listing view 2020-10-05 13:54:01 +02:00
go.sum Apply fine-grained spinner display rules to file listing view 2020-10-05 13:54:01 +02:00
LICENSE Add LICENSE 2019-12-18 21:33:48 -05:00
main.go Disable identity & force-key flags 2020-10-05 13:53:26 +02:00
Makefile Correct env var placement in Makefile 2020-10-05 13:50:04 +02:00
README.md Update Charm badge 2020-10-05 13:53:26 +02:00
stash.go Set ID of newly stashed markdowns so we can operate on them 2020-10-05 13:53:26 +02:00

Glow

Render markdown on the CLI, with pizzazz!

Glow Logo Latest Release GoDoc Build Status Go ReportCard

Glow UI Demo

What is it?

Glow is a terminal based markdown reader designed from the ground up to bring out the beauty—and power—of the CLI.

Use it to quickly discover markdown files in a folder (it will automatically search subdirectories for you), read documentation directly on the command line and stash markdown files to your own private collection in the Charm Cloud so you can read them anywhere.

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.

Stashing

Glow works with the Charm Cloud to allow you to store any markdown file in your own private collection. When you run:

glow stash README.md

You'll add that markdown file to your stash. Running glow without arguments will let you browse through all your stashed documents. This is a great way to keep track of documentation that you need to reference.

Stashing is private and your stash and its contents will not be exposed publicly.

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

MIT


Part of Charm.

the Charm logo

Charm热爱开源!