Render markdown on the CLI, with pizzazz! 💅🏻
  • Go 99.9%
  • Dockerfile 0.1%
Find a file
2019-12-13 03:29:52 +01:00
.goreleaser.yml Add goreleaser config to help automate builds for various platforms 2019-11-24 02:39:02 +01:00
github.go Handle relative URLs in markdown, when a BaseURL is provided 2019-11-26 00:35:11 +01:00
gitlab.go Handle relative URLs in markdown, when a BaseURL is provided 2019-11-26 00:35:11 +01:00
main.go Add godoc comments to public types 2019-12-10 17:18:59 +01:00
README.md Link to gallery from related Styles paragraph 2019-12-13 03:29:52 +01:00

Gold

Render markdown on the CLI, with pizzazz!

Usage

Use a markdown source as the primary argument:

Read from file:

./gold README.md

Read from stdin:

./gold -

Fetch README from GitHub:

./gold github.com/charmbracelet/gold

Fetch markdown from an HTTP source:

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

When gold is started without any 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:

./gold -w 60

Styles

You can choose a style with the -s flag (dark being the default):

./gold -s [dark|light]

Alternatively you can also supply a custom JSON stylesheet:

./gold -s mystyle.json

Check out the Gold Style Gallery to find more available styles!

Example Output

Gold Dark Style

Colors

Currently gold uses the Aurora ANSI colors.