{"id":39721495,"url":"https://github.com/atani/glowm","last_synced_at":"2026-06-03T04:00:42.173Z","repository":{"id":333240113,"uuid":"1136628607","full_name":"atani/glowm","owner":"atani","description":"Read Markdown docs in your terminal with Mermaid diagrams rendered inline (iTerm2/Kitty/Ghostty). PDF export, pager, and STDIN support.","archived":false,"fork":false,"pushed_at":"2026-06-02T23:59:37.000Z","size":11026,"stargazers_count":14,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-03T00:04:27.230Z","etag":null,"topics":["adr","cli","diagrams","documentation","glow","golang","markdown","mermaid","terminal","tui"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atani.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":["atani"]}},"created_at":"2026-01-18T03:15:42.000Z","updated_at":"2026-06-02T23:05:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"eaaab7de-ef32-41db-a100-9d94f91f238a","html_url":"https://github.com/atani/glowm","commit_stats":null,"previous_names":["atani/glowm"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/atani/glowm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atani%2Fglowm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atani%2Fglowm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atani%2Fglowm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atani%2Fglowm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atani","download_url":"https://codeload.github.com/atani/glowm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atani%2Fglowm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33847265,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adr","cli","diagrams","documentation","glow","golang","markdown","mermaid","terminal","tui"],"created_at":"2026-01-18T10:47:37.942Z","updated_at":"2026-06-03T04:00:42.162Z","avatar_url":"https://github.com/atani.png","language":"Go","funding_links":["https://github.com/sponsors/atani"],"categories":[],"sub_categories":[],"readme":"# glowm\n\n[![codecov](https://codecov.io/gh/atani/glowm/branch/main/graph/badge.svg)](https://codecov.io/gh/atani/glowm)\n\n**Read Markdown architecture docs in your terminal — with Mermaid diagrams rendered inline.**\n\n`glowm` is a terminal-first Markdown viewer for developers who keep design docs, ADRs, and diagrams next to the code. It renders Markdown beautifully in the terminal, displays Mermaid diagrams inline on modern terminals like iTerm2, Kitty, and Ghostty, and can export diagrams to PDF when you need to share them outside the terminal.\n\n\u003e Stop opening a browser just to preview Mermaid diagrams in Markdown.\n\n![glowm demo screenshot](docs/README-demo.png)\n\n## Why glowm?\n\nMany engineering teams keep architecture notes, runbooks, ADRs, and design documents in Markdown. Mermaid makes those docs more useful, but most terminal Markdown viewers leave Mermaid blocks as plain code.\n\n`glowm` keeps the whole workflow in your terminal:\n\n- **Inline Mermaid diagrams** on iTerm2, Kitty, and Ghostty\n- **PDF export** for Mermaid diagrams when you need an artifact\n- **Pager-first reading** for long documentation files\n- **STDIN support** for piping generated docs or command output\n- **Glow-like Markdown rendering** with familiar terminal ergonomics\n\n## Perfect for\n\n- Reading architecture docs and ADRs without leaving the terminal\n- Previewing Mermaid-heavy README files before committing\n- Reviewing documentation in SSH sessions or terminal-only workflows\n- Exporting diagrams from Markdown docs to PDF\n- Teams that prefer docs-as-code over browser-only documentation tools\n\n## Install\n\n### Homebrew\n\n```bash\nbrew tap atani/tap\nbrew install glowm\n```\n\n### Go\n\n```bash\ngo install github.com/atani/glowm/cmd/glowm@latest\n```\n\n## Quick start\n\n```bash\n# Render Markdown to ANSI output\nglowm README.md\n\n# Read from STDIN\ncat README.md | glowm -\n\n# Export Mermaid diagrams to PDF\nglowm --pdf README.md \u003e diagrams.pdf\n```\n\n## Mermaid rendering\n\nWhen stdout is a supported terminal, Mermaid code blocks are rendered inline as images:\n\n- iTerm2\n- Kitty\n- Ghostty\n\nOn other terminals, Mermaid blocks gracefully fall back to code blocks.\n\nChrome or Chromium is required for Mermaid rendering and PDF export.\n\n## Comparison\n\n| Feature | glowm | Glow | Browser preview | VS Code preview |\n| --- | --- | --- | --- | --- |\n| Terminal Markdown reading | ✅ | ✅ | ❌ | ❌ |\n| Inline Mermaid diagrams in terminal | ✅ | ❌ | ❌ | ❌ |\n| Mermaid PDF export | ✅ | ❌ | Varies | Varies |\n| Works with STDIN / pipes | ✅ | ✅ | ❌ | ❌ |\n| Good for SSH / terminal-only workflows | ✅ | ✅ | ❌ | ❌ |\n| Docs stay close to the codebase | ✅ | ✅ | ✅ | ✅ |\n\n## Options\n\n- `-w` Word wrap width\n- `-s` Style name (`dark`, `light`, `notty`, `auto`) or JSON style path\n- `-p` Force pager output, overriding `--no-pager`\n- `--no-pager` Disable default pager; pager is on by default for TTY\n- `--pdf` Export Mermaid diagrams to PDF via stdout\n- `--version` Show version information\n\n## Config\n\n`glowm` reads the config file from the OS-specific user config directory:\n\n- **macOS**: `~/Library/Application Support/glowm/config.json`\n- **Linux**: `~/.config/glowm/config.json` or `$XDG_CONFIG_HOME/glowm/config.json`\n- **Windows**: `%AppData%\\\\glowm\\\\config.json`\n\nExample:\n\n```json\n{\n  \"pager\": {\n    \"mode\": \"vim\"\n  }\n}\n```\n\n## Requirements\n\n- Go, when installing from source\n- Chrome or Chromium, required for Mermaid rendering and PDF export\n- A terminal with image support for inline diagrams: iTerm2, Kitty, or Ghostty\n\n## Launch notes\n\nMaintainers can use [`docs/launch-kit.md`](docs/launch-kit.md) for English launch copy and [`docs/global-launch-checklist.md`](docs/global-launch-checklist.md) for repository metadata and posting order.\n\n## Contributing\n\nIssues and pull requests are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for development notes.\n\n## Support\n\n[![GitHub Sponsors](https://img.shields.io/badge/Sponsor-%E2%9D%A4-ea4aaa?logo=github)](https://github.com/sponsors/atani)\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatani%2Fglowm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatani%2Fglowm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatani%2Fglowm/lists"}