$ show charmbracelet/glow
Glow is a terminal-based markdown reader written in Go. It provides both a CLI mode for rendering markdown files directly to the terminal and a TUI mode for browsing and reading local markdown files with a pager interface. The application supports reading from files, stdin, HTTP URLs, and GitHub/GitLab repositories via their APIs. It features syntax highlighting via Glamour, word wrapping, custom styles, and a configuration file. The architecture is modular: the main entry point parses commands and arguments, delegates to either the CLI renderer or the TUI program, which is built on the Bubble Tea framework. The UI is split into a stash view (file listing) and a pager view (document rendering), with models and views separated. A notable feature is support for Kitty terminal's text sizing protocol (OSC 66) to scale heading sizes, implemented in a self-contained utility module. The codebase demonstrates strong Go practices, clean abstractions, and thorough testing.
The LLM identified 5 files worth highlighting for reuse:
Implements detection and application of Kitty terminal's text sizing protocol (OSC 66) to scale heading sizes in rendered markdown. The module auto-detects terminal support, adds size markers to heading styles, and replaces them with OSC 66 sequences for 1.5x, 2x, and 3x scaling. It handles edge cases like wrapped headings, nested styles, and malformed markers. This is a self-contained utility that could be extracted for use in any terminal application needing text scaling, demonstrating deep knowledge of terminal escape sequences and Unicode grapheme handling.
Provides a clean, self-contained function to fetch a repository's README using the GitHub API. It parses the owner/repo from a URL, calls the GitHub readme endpoint, and returns the content as a stream. Error handling is thorough, and the function is independent of the rest of the application. This pattern is reusable for any project that needs to retrieve GitHub READMEs programmatically.
Mirror of github.go for GitLab repositories. It uses the GitLab API v4 to fetch the project's README, handling URL encoding of the project path and converting the blob URL to raw. The function is self-contained and demonstrates a clean API client pattern that can be reused for GitLab integration in other tools.
Contains reusable markdown utility functions, most notably RemoveFrontmatter and detectFrontmatter, which strip YAML/TOML front matter from markdown content using regex. These functions are pure, operate on byte arrays, and have no external dependencies beyond the standard library. They can be extracted and used in any markdown processing pipeline. The file also includes helper functions for path expansion, code block wrapping, and markdown extension detection.
The normalize function in this file removes diacritics from text (e.g., 'ö' becomes 'o') using Unicode NFD normalization and filtering of nonspacing marks. This is a common requirement for search/filter functionality in text-heavy applications. The function is self-contained, uses standard Go text libraries, and can be extracted for use in any project needing accent-insensitive string comparison or indexing.