Glow — читать Markdown в терминале

Горящая лампа накаливания

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

Что такое Markdown и почему его трудно читать в терминале

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

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

Фрагмент сырого Markdown в терминале

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

Быстрый обзор возможностей

Рендеринг Markdown с поддержкой заголовков, списков, таблиц, кода и ссылок.
Режим TUI для навигации по локальной коллекции Markdown.
Возможность сохранять (stash) интересные статьи для быстрого доступа.
Загрузка README с GitHub и рендеринг URL-ов.
Поддержка тем (светлая/тёмная) и кастомных стилей.

Установка Glow на Linux — пошагово

Ниже — проверенные способы установки для популярных дистрибутивов. Команды приведены так, чтобы их можно было скопировать в терминал.

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

Добавьте ключ и репозиторий Charm:

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

Проверка установки:

glow --version

На 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

Или для dnf:

sudo dnf install glow

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

sudo pacman -S glow

Через Snap

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

sudo snap install glow

Альтернативы установки и переносимость

Вы можете скачать prebuilt бинарник с GitHub-репозитория проекта (если доступен) и поместить в /usr/local/bin.
Для серверов без доступа к внешним репозиториям используйте статическую сборку или копирование бинарника.

Важно: всегда проверяйте релиз на официальной странице проекта перед установкой в критичных окружениях.

Основы использования Glow

Обычный запуск для одного файла:

glow this-document.md

Если запустить без аргументов, откроется TUI-интерфейс, где можно рекурсивно просматривать Markdown-файлы в текущем каталоге:

glow

Вы увидите список файлов, навигация — стрелки, Enter (Return) для открытия, Esc — назад.

Чтобы запустить Glow для конкретной директории:

glow ~/my/markdown/file/dump/

Команды для работы со stash (коллекцией материалов):

Сохранить текущий файл в коллекцию:

glow stash this-document.md

Открыть интерфейс stash: в TUI нажать Tab и перейти на вкладку “stash”.

Пример рендеринга README из GitHub:

glow github.com/charmbracelet/glow

Или рендеринг по произвольному URL:

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

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

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

Glow автоматически пытается определить тему терминала. Вы можете явно задать тему через флаг -s:

glow -s light

glo w -s dark

Для использования кастомного стиля (файла JSON):

glow -s mystyle.json

Советы по кастомизации:

Подберите тему, читаемую в вашем терминале (высокая контрастность для долгого чтения).
Для привязки Glow к сочетанию клавиш в вашей оболочке создайте алиас:

alias md='glow'

Храните свой stash в отдельной директории, если хотите синхронизировать её через dotfiles.

Командная памятка (cheat sheet)

Открыть файл: glow file.md
Открыть директорию: glow path/
Открыть TUI: glow
Сохранить в stash: glow stash file.md
Рендер GitHub: glow github.com/org/repo
Рендер по URL: glow https://host.tld/file.md
Тема: glow -s light|dark|mystyle.json

Когда Glow не подходит (ограничения и анти-примеры)

Если вам нужен полноценный WYSIWYG-редактор для правки Markdown с живым предпросмотром, Glow не заменит GUI-редакторы.
Для сложной верстки с расширениями (например, LaTeX-рендеринг, диаграммы с плагинами), Glow может не поддерживать все расширения.
Если в вашем workflow есть обширная работа с изображениями, вложенными ресурсами или активными элементами, удобнее использовать браузер/GUI.

Подходы и альтернативы

Использовать GUI Markdown-ридеры или онлайн-просмотрщики для сложного контента.
Комбинация: использовать Glow для быстрой проверки в терминале и GUI для финального просмотра.
Для автозагрузки и CI-проверок рендерить Markdown в HTML на сервере и публиковать как статическую документацию.

Руководство по внедрению в рабочий процесс (playbook)

Установить Glow на рабочие станции и сервера поддержки документации.
Создать alias ‘md’ или ‘glowmd’ в профиле оболочки всех участников команды.
Определить директорию stash в dotfiles и настроить её синхронизацию (опционально).
Добавить в README проекта заметку: ‘Recommends: glow for terminal reading’.
Обучить коллег: короткий 10-минутный демо-сессия по навигации TUI и stash.

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

Участники команды могут открыть README любого репозитория и прочитать его с форматированием в течение 1 минуты.
Stash используется хотя бы одним разработчиком для быстрого доступа к версии документа.

Чек-листы по ролям

Для разработчика:

Установить glow локально
Настроить alias в .bashrc/.zshrc
Протестировать открытие README репозитория

Для системного администратора:

Установить Glow на тестовом сервере
Проверить стабильность на headless-сервере
Документировать процедуру обновления пакета

Для техрайтера:

Проверить отображение таблиц и списков
Убедиться, что ссылки и изображения корректны в рендере
Добавить инструкции для читателей о просмотре в терминале

Набор тестов и критерии приёмки

Тест 1 — Открытие локального README:

Вход: локальный файл README.md
Действие: glow README.md
Ожидаемый результат: заголовки, списки и выделение отображаются корректно

Тест 2 — Загрузка с GitHub:

Вход: публичный репозиторий
Действие: glow github.com/org/repo
Ожидаемый результат: README загружается и рендерится без ошибок

Тест 3 — Stash:

Действие: glow stash path/to/file.md
Ожидаемый результат: файл появляется в разделе stash TUI

Ментальные модели и эвристики

“Render-first”: думайте о терминах документа с точки зрения чтения, а не редактирования — Glow предназначен для потребления контента.
“TUI как каталог”: используйте TUI для быстрого поиска и демонстрации читабельных версий документов.
“Stash как закладки”: храните часто используемые руководства в stash, чтобы не искать их по диску.

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

Glow хорошо работает в большинстве современных терминалов с поддержкой 256 цветов. Для старых терминалов возможны артефакты оформления.
На серверах без GUI рекомендуется ставить бинарник или пакет из официального репозитория проекта, если доступен.
При миграции dotfiles не забудьте синхронизировать stash (если она используется).

Краткая справка по безопасности и приватности

Glow загружает внешние URL-ы по HTTP/HTTPS. На закрытых системах блокируйте доступ по URL при необходимости.
При сохранении в stash проверьте, что приватные документы не попадут в публичные репозитории.

Справочник терминов (1‑строчная глоссария)

Markdown — легковесный язык разметки для форматирования текста.
TUI — text user interface, текстовый интерфейс пользователя.
Stash — внутренняя коллекция сохранённых статей Glow.

Резюме

Glow — простой и практичный инструмент для чтения Markdown прямо в терминале. Установка возможна на большинстве дистрибутивов Linux, использование интуитивно: один файл, директория, URL или GitHub-репозиторий. Для большинства задач чтения документации в разработке и эксплуатации Glow значительно экономит время и ресурсы, не требуя перехода в графический интерфейс.

Важно: если вам нужен полноценный редактор или расширённая поддержка плагинов Markdown, сочетайте Glow с GUI-инструментами.

Ключевые команды: glow <файл|папка|URL|github>, glow -s <тема>, glow stash <файл>.

Спасибо за чтение — попробуйте запустить glow в каталоге с проектом и оцените UX чтения README в пару кликов.

Glow — читать Markdown прямо в терминале