mirror of
https://github.com/rwinkhart/glamour-temp-MUTN.git
synced 2026-09-01 22:47:25 -04:00
68 lines
2.1 KiB
Markdown
68 lines
2.1 KiB
Markdown
# Glamour
|
|
|
|
[](https://github.com/charmbracelet/glamour/releases)
|
|
[](https://pkg.go.dev/github.com/charmbracelet/glamour?tab=doc)
|
|
[](https://github.com/charmbracelet/glamour/actions)
|
|
[](https://coveralls.io/github/charmbracelet/glamour?branch=master)
|
|
[](http://goreportcard.com/report/charmbracelet/glamour)
|
|
|
|
Write handsome command-line tools with *glamour*!
|
|
|
|
`glamour` lets you render [markdown](https://en.wikipedia.org/wiki/Markdown)
|
|
documents & templates on [ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code)
|
|
compatible terminals. You can create your own stylesheet or use one of our
|
|
glamourous default themes.
|
|
|
|
|
|
## Usage
|
|
|
|
```go
|
|
import "github.com/charmbracelet/glamour"
|
|
|
|
in := `# Hello World
|
|
|
|
This is a simple example of glamour!
|
|
Check out the [other examples](https://github.com/charmbracelet/glamour/tree/master/examples).
|
|
|
|
Bye!
|
|
`
|
|
|
|
out, _ := glamour.Render(in, "dark")
|
|
fmt.Print(out)
|
|
```
|
|
|
|
|
|
|
|
### Custom Renderer
|
|
|
|
```go
|
|
import "github.com/charmbracelet/glamour"
|
|
|
|
r, _ := glamour.NewTermRenderer(
|
|
// detect background color and pick either the default dark or light theme
|
|
glamour.WithAutoStyle(),
|
|
// wrap output at specific width
|
|
glamour.WithWordWrap(40),
|
|
)
|
|
|
|
out, _ := r.Render(in)
|
|
fmt.Print(out)
|
|
```
|
|
|
|
|
|
## Styles
|
|
|
|
You can find all available default styles in our [gallery](https://github.com/charmbracelet/glamour/tree/master/styles/gallery).
|
|
Want to create your own style? [Learn how!](https://github.com/charmbracelet/glamour/tree/master/styles)
|
|
|
|
|
|
## Glamourous Projects
|
|
|
|
Check out [Glow](https://github.com/charmbracelet/glow), a markdown renderer for
|
|
the command-line, which uses `glamour`.
|
|
|
|
|
|
## License
|
|
|
|
[MIT](https://github.com/charmbracelet/glamour/raw/master/LICENSE)
|