Чтение Markdown в терминале с Glow

Горящая лампочка накаливания на тёмном фоне

Markdown удобен для написания, потому что позволяет форматировать документ в любом текстовом редакторе: заголовки, фрагменты кода, жирный и курсивный текст, чек-листы, списки, таблицы и другие элементы. Но если открыть Markdown в простом терминале — вы увидите синтаксис, а не готовое форматирование.

Glow — это утилита командной строки, которая отображает Markdown так, как его ожидают читать люди: красиво и удобно прямо в терминале.

Что такое Markdown и почему его сложно отобразить в терминале

Markdown — это соглашение для форматирования текста. Оно противоположно редакторам WYSIWYG: вместо визуального интерфейса вы пишете простые символы (например, # для заголовков, * для списка), а затем парсер преобразует их в форматированный вывод или HTML.

Преимущество Markdown в простоте: можно создавать документы в nano, vim или Emacs без тяжёлого GUI. Но для чтения вам нужен рендерер: простое чтение файла через cat или открытие в редакторе покажет исходный синтаксис, а не форматированный документ.

Отображение сырого Markdown через cat с неудобочитаемым синтаксисом

Если вы часто работаете с репозиториями Git, README.md и другие Markdown-файлы встречаются постоянно. Постоянное переключение внимания между «в уме» отрисовкой Markdown и восприятием содержания замедляет работу. Glow решает эту проблему, давая нативный рендер в терминале и TUI для навигации.

Почему выбрать Glow: быстрота и минимализм

Glow спроектирован для чтения, а не для редактирования. Ключевые преимущества:

Рендер Markdown с поддержкой таблиц, списков, ссылок и кода.
Лёгкая установка для большинства дистрибутивов Linux и поддержка snap.
TUI для навигации по локальным файлам и сохранённым (stash) статьям.
Поддержка тем (тёмная/светлая) и пользовательских стилей.

Установка Glow на Linux

Glow не всегда есть в официальных репозиториях, но установка остаётся простой. Ниже — инструкции для популярных дистрибутивов.

На Debian и производных (Ubuntu и др.)

Добавьте ключ GPG и репозиторий, затем установите пакет:

sudo mkdir -p /etc/apt/keyrings  
curl -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg  
echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/ * *" | sudo tee /etc/apt/sources.list.d/charm.list

Обновите список пакетов и установите Glow:

sudo apt update  
sudo apt install glow

Важно: команды добавляют ключ в системный keyring и регистрируют репозиторий — убедитесь, что у вас есть права sudo.

На Fedora, RHEL и RPM-совместимых

Создайте репозиторий и установите пакет:

echo '[charm]  
name=Charm  
baseurl=https://repo.charm.sh/yum/  
enabled=1  
gpgcheck=1  
gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repo

Затем установите:

sudo yum install glow

На новых Fedora альтернативой может быть dnf вместо yum.

На Arch Linux и производных

sudo pacman -S glow

Через Snap

Если у вас настроен Snap Store:

sudo snap install glow

Если Snap не установлен, просмотрите справочник по установке Snap для вашей системы и прав.

Как читать Markdown с помощью Glow

Самый простой способ — передать путь к файлу как аргумент:

glow this-document.md

Рендер Markdown в терминале с помощью Glow

Glow отобразит жирный и курсивный текст, цитаты, таблицы, списки и ссылки. У Glow также есть TUI: запустите просто:

glow

TUI покажет рекурсивный список локальных Markdown-файлов. Навигация — стрелками клавиатуры, Enter для выбора, Esc для возврата. Чтобы открыть конкретную директорию:

glow ~/my/markdown/file/dump/

Чтобы сохранить (stash) текущий файл через TUI — откройте его и нажмите S. Альтернативно можно выполнить:

glow stash this-document.md

Найти сохранённые статьи можно через вкладку “stash” в TUI (нажмите Tab).

Чтение удалённых файлов и README с GitHub

Glow умеет рендерить удалённый Markdown напрямую из URL или репозитория GitHub.

Пример для GitHub README:

glow github.com/charmbracelet/glow

Для любого URL:

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

Это удобно при быстром просмотре README без клонирования репозитория.

Настройка стиля и темы

Glow пытается автоматически определить цветовую схему терминала, но вы можете задать тему вручную:

glow -s light

Или тёмная тема:

glow -s dark

Пользовательская тема в виде JSON-стилей:

glow -s mystyle.json

Список доступных стилей обычно хранится в директории конфигурации утилиты — проверьте документацию Glow для версии, которую установили.

Важно: пользовательская тема должна соответствовать поддерживаемым полям цвета в Glow; неверная структура JSON приведёт к ошибке загрузки стиля.

Быстрый шпаргалка (Cheat sheet)

Просмотр файла: glow path/to/file.md
Запуск TUI: glow
Открыть директорию: glow path/to/dir/
Сохранить в stash: glow stash file.md
Загрузить README GitHub: glow github.com/user/repo
Тема: glow -s dark или glow -s light

Дополнительные флаги можно найти в справке:

glow --help

Альтернативные инструменты и когда Glow может не подойти

bat — подсветка синтаксиса для кода и постраничный просмотр; хорош для файлов с кодом, но не полноценный Markdown-рендерер.
mdless — лёгкий просмотрщик Markdown в терминале с навигацией; более минималистичный, чем Glow.
Graphical Markdown-редакторы (Typora, Obsidian) — удобнее для редактирования и визуального предварительного просмотра, но требуют GUI.

Когда Glow не подходит:

Когда вам нужно интерактивно редактировать документ — используйте редактор (vim, nano, VS Code).
Если ваш Markdown включает расширения (custom HTML, плагины рендерера), Glow может отобразить не всё корректно.

Ментальные модели при выборе инструмента

“Read vs Edit” — выбирайте Glow, если задача — читать и быстро ориентироваться; редакторы — когда нужно править.
“Local-first” — если вы часто читаете локальные README и заметки, TUI Glow ускоряет доступ.
“Remote quick-check” — для быстрого осмотра удалённого README без клона используйте glow github.com/…

Ролевые чек-листы

Разработчик

Установить glow на dev-машину
Быстро просматривать README и CONTRIBUTING
Использовать stash для часто читаемых гайдов

Системный администратор

Установить через пакетный менеджер репозитория вашей ОС
Проверить GPG-ключи репозитория при добавлении
Ограничить установку snap, если политика безопасности этого требует

Автор документации

Убедиться, что Markdown совместим с рендерером (стандарт CommonMark)
Тестировать сложные блоки (таблицы, код) в Glow
Добавлять короткие заголовки и якоря для навигации в TUI

Совместимость и советы по миграции

Платформа	Способ установки	Примечания
Debian/Ubuntu	apt + репозиторий charm	Требуется добавление ключа в /etc/apt/keyrings
Fedora/RHEL	yum/dnf + репо	Проверьте SELinux/политику репозиториев
Arch	pacman	Пакет доступен в официальных репозиториях
Универсально	snap	Требуется snapd; не всегда желателен в корпоративных системах

При миграции с другого инструмента убедитесь, что:

Ваши workflow (stash, поиск, TUI) совместимы.
Утилита поддерживает те расширения Markdown, которые вы используете.

Безопасность и приватность

При использовании команд типа glow https://host.tld/file.md контент загружается из сети. Убедитесь, что URL надёжный.
Проверяйте GPG-ключи репозиториев перед их добавлением в систему.
В корпоративной среде ограничьте использование snap/repo-источников, если политика запрещает внешние источники.

Примеры использования и сценарии

Просмотр часто используемой коллекции заметок:

# Откройте директорию с заметками
glow ~/notes/

# Быстрый просмотр одного файла
glow ~/notes/README.md

# Сохранить статью в stash
glow stash ~/notes/useful-guide.md

Поиск и просмотр README удалённого репозитория:

glow github.com/psf/requests

Пример пользовательского workflow

Открыли терминал и запустили glow — получили список локальных файлов.
Навигировали по TUI, открыли нужную статью и нажали S — добавили в stash.
На сервере без GUI быстро проверили README с GitHub: glow github.com/user/repo.

1‑строчный глоссарий

Markdown — лёгкий язык разметки для форматирования текста.
TUI — текстовый пользовательский интерфейс (терминальный UI).
Stash — сохранённая заметка/статья в Glow для быстрого доступа.

Краткое объявление (100–200 слов)

Glow — небольшая и удобная утилита для чтения Markdown в терминале. Она рендерит заголовки, списки, таблицы и блоки кода прямо в консоли, предоставляет TUI для навигации по локальным файлам, позволяет сохранять заметки в stash и загружать README из GitHub. Glow легко устанавливается на большинство дистрибутивов Linux: через apt (с добавлением репозитория charm), через yum/dnf для RPM-систем, pacman для Arch и через snap. Если вы цените скорость, минимализм и предпочитаете работать без GUI — Glow заметно улучшит качество жизни при работе с документацией.

Критерии приёмки

Команда glow file.md открывает файл и рендерит Markdown без ошибок.
TUI запускается командой glow и позволяет навигацию стрелками и Enter.
Сохранение в stash работает через TUI (клавиша S) и через glow stash.

Часто задаваемые вопросы

Как быстро увидеть список доступных опций Glow?

Выполните glow --help — вы получите полный список флагов и краткое описание.

Glow поддерживает расширения CommonMark или GitHub Flavored Markdown?

Glow ориентирован на классический рендеринг Markdown и корректно обрабатывает большинство распространённых конструкций, включая таблицы, списки и кодовые блоки. Специфические нестандартные расширения могут не поддерживаться.

Безопасно ли загружать файлы через URL?

Загрузка через URL выполняется как обычный HTTPS-запрос. Не открывайте подозрительные ресурсы, особенно в среде с повышенными требованиями к безопасности.

Краткое резюме:

Glow упрощает чтение Markdown прямо в терминале.
Утилита подходит для людей, которые работают без GUI или часто читают README в репозиториях.
Установить можно на большинство дистрибутивов; также доступен snap.
Для командной работы и автоматизации используйте glow github.com/... и glow stash.

Примечание: для подробностей по флагам и совместимости обращайтесь к glow --help и документации к версии, которую установили.

Как читать Markdown в терминале с Glow