Как читать документы Markdown в терминале Linux с помощью Glow
Linux

Как читать документы Markdown в терминале Linux с помощью Glow

Glow – это программа для чтения Markdown в терминале для Linux, которая поставляется со всеми благами и свистками. Вот как установить и использовать его в Linux

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

Glow – это утилита командной строки, которая отображает документы Markdown так, как они должны быть прочитаны

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

Markdown – это соглашение для форматирования текста, и это практически противоположность редактору типа What You See Is What You Get (WYSIWYG)

Документы Markdown содержат множество символов, которые показывают, как текст должен быть отформатирован на странице. Эти символы интерпретируются синтаксическим анализатором Markdown и либо отображаются в программе для чтения документов, либо преобразуются в HTML для отображения в Интернете

Именно потому, что Markdown полагается на интерпретацию символов внешним приложением, вы можете создать его даже в самом простом текстовом редакторе. Вам не нужно скачивать многогигабайтный MS Office, чтобы создать документ Markdown; вы можете сделать это в nano, vim или Emacs

Отображение документов Markdown – это совсем другое дело. Конечно, вы можете снова открыть их в nano или использовать cat для просмотра содержимого файла, но вы не увидите Markdown в том виде, в котором он должен быть для читателей; вместо этого вы увидите символы форматирования

Для пользователей, которые тратят много времени на клонирование репозиториев Git, это быстро превращается в рутину. Файлы Git README обычно представляют собой документы в формате Markdown, а если разделить внимание между мысленной визуализацией документа в формате Markdown и перевариванием его содержимого, можно многое пропустить

Хотя вы можете использовать специальный графический интерфейс для рендеринга Markdown или зайти на сайт, это означает, что вам придется расфокусироваться и покинуть терминал. Если вы используете VPS или испытываете отвращение к графическим интерфейсам любого рода, вам не повезет

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

Как установить Glow на Linux

Хотя Glow отсутствует в официальных репозиториях большинства дистрибутивов Linux, установить его несложно

О Debian и его производных

Чтобы установить Glow на дистрибутивы на базе Ubuntu и Debian, сначала нужно добавить ключ Glow 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

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

Чтобы загрузить и установить Glow на 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

Затем установите Glow, набрав:

sudo yum install glow

Об Arch Linux и его производных

Вы можете установить Glow на дистрибутивы на базе Arch, используя стандартный менеджер пакетов Pacman

sudo pacman -S glow

Установите Glow в кратчайшие сроки

Если вам посчастливилось иметь систему, поддерживаемую фирменным магазином Snap Store от Canonical, вы можете установить Glow с помощью:

sudo snap install glow

Для тех, у кого Snap не установлен или кто не знает, как он работает, ознакомьтесь с нашим подробным руководством по установке и использованию Snap Store в Linux

Использование Glow для чтения документов Markdown в терминале

Самый простой способ использовать Glow – передать ему в качестве аргумента файл Markdown:

glow this-document.md

Как вы можете видеть, Glow отобразил сложный документ, в котором присутствуют жирный и курсивный шрифт, цитируемый текст, таблицы, списки и ссылки с якорным текстом

Это довольно красиво, и Glow также поставляется с интерфейсом пользователя терминала. Вы можете активировать его с помощью:

glow

и Glow представит вам рекурсивный список локальных файлов Markdown. Вы можете перемещаться по списку с помощью стрелок клавиатуры и нажимать Return, чтобы выбрать один из них. Нажатие Esc вернет вас в главное меню

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

glow ~/my/markdown/file/dump/

Glow упрощает хранение файлов Markdown для последующего быстрого обращения к ним. Просто откройте любой документ Markdown с помощью Glow TUI и нажмите S на клавиатуре

В качестве альтернативы, если вам не нравится открывать полный TUI, чтобы спрятать документ Markdown, который находится прямо перед вами, запустите:

glow stash this-document.md

Вы можете найти сохраненные статьи в главном TUI, используя клавишу Tab для перехода на вкладку ‘тайник’

Используйте Glow для чтения документов в формате Markdown онлайн

Glow отлично работает с файлами README на GitHub, и если вы знаете имя нужного вам репозитория, то:

glow github.com/charmbracelet/glow

приведет к тому, что Glow README будет извлечен из GitHub и выведен в стандартный вывод

Если ваш файл Markdown находится в другом месте, вы можете использовать:

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

Настройте Glow для отображения Markdown в терминале

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

glow -s light

Или переключитесь в темный режим с помощью:

glow -s dark

Если у вас есть пользовательская таблица стилей, вы можете легко использовать ее и в Glow:

glow -s mystyle.json

Glow упрощает рендеринг документов Markdown

Чтение документов Markdown в терминале – это огромное улучшение качества жизни, и означает, что вам не нужно тратить системные ресурсы на открытие еще одного приложения или браузера с графическим интерфейсом

Если вам захочется отдохнуть от чтения длинных документов в формате Markdown, вы можете искать видео на YouTube в терминале!

Об авторе

Алексей Белоусов

Привет, меня зовут Филипп. Я фрилансер энтузиаст . В свободное время занимаюсь переводом статей и пишу о потребительских технологиях для широкого круга изданий , не переставая питать большую страсть ко всему мобильному =)

Комментировать

Оставить комментарий