1---
 2name: charm-glow
 3description: "View and browse markdown files in the terminal with glow - CLI and TUI modes, pager, word wrapping, styles. Use when viewing markdown in the terminal, glow, or browsing markdown files from the command line. NOT for rendering markdown programmatically in Go (use glamour)."
 4---
 5
 6# charm-glow
 7
 8`glow` renders markdown in the terminal with styled output. Has two modes: TUI (browse/stash) and CLI (direct render).
 9
10## CLI Usage
11
12```bash
13# Read a local file
14glow README.md
15
16# Read from stdin
17echo "# Hello" | glow -
18
19# Fetch from GitHub/GitLab
20glow github.com/charmbracelet/glow
21
22# Fetch from URL
23glow https://host.tld/file.md
24```
25
26## Pager Mode
27
28```bash
29# Enable pager (defaults to less -r if $PAGER not set)
30glow -p README.md
31```
32
33## Word Wrap
34
35```bash
36# Wrap at N columns
37glow -w 80 README.md
38```
39
40## Styles
41
42```bash
43# Auto-detect from terminal background (default)
44glow README.md
45
46# Force dark or light
47glow -s dark README.md
48glow -s light README.md
49
50# Custom JSON stylesheet (glamour format)
51glow -s mystyle.json README.md
52```
53
54Styles come from [glamour](https://github.com/charmbracelet/glamour/blob/master/styles/gallery/README.md). Custom styles are JSON files following glamour's schema.
55
56## TUI Mode
57
58Run `glow` with no args to open the TUI. It scans the current directory (or git repo root) for `.md` files.
59
60- Navigate with arrow keys / vim keys
61- Open file to enter pager, press `?` for hotkeys
62- Pager uses `less`-compatible keybindings
63
64## Config File
65
66```bash
67glow config   # opens $EDITOR
68```
69
70Config lives at platform default path (check `glow --help`). Example `glow.yml`:
71
72```yaml
73style: "auto"       # "dark" | "light" | "auto" | path to JSON
74pager: true         # always use pager
75width: 80           # word wrap column
76mouse: true         # mouse support in TUI
77all: false          # show hidden/gitignored files
78showLineNumbers: false
79preserveNewLines: false
80```
81
82## Key Flags Summary
83
84| Flag | Description |
85|------|-------------|
86| `-s` | Style: dark, light, auto, or path to JSON |
87| `-w` | Word wrap width |
88| `-p` | Enable pager |
89
90## Notes
91
92- Stash feature (syncing to Charm Cloud) was removed in v2
93- `glow --help` lists config file location per platform