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 — это другое дело. Конечно, вы можете снова открыть их в нано или использовать кот для просмотра содержимого файла, но вы не увидите разметку, отображаемую так, как это должно быть для читателей; вместо этого вы увидите символы форматирования.
Для пользователей, которые проводят много времени клонирование репозиториев 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
завиток -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [подписанный =/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/" | sudo tee /etc/apt/sources.list.d/charm.list
Обновите список пакетов вашей системы, затем установите Glow с помощью:
Судо подходит обновлять
Судо подходит установить светиться
Установите Glow на Fedora
Чтобы загрузить и установить Glow на Fedora, RHEL и другие дистрибутивы на основе RPM, сначала выполните следующую команду:
эхо '[очарование]
имя = Очарование
базовый URL=https://repo.charm.sh/yum/
включено=1
gpgcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.key' | тройник судо /etc/yum.repos.d/charm.repo
Затем установите Glow, набрав:
судо ням установить светиться
Об Arch Linux и его производных
Вы можете установить Glow в дистрибутивы на основе Arch, используя менеджер пакетов по умолчанию, Pacman.
sudo pacman -S свечение
Установите Glow как оснастку
Если вам посчастливилось иметь систему, поддерживаемую проприетарным Snap Store Canonical, вы можете установить Glow с помощью:
sudo snap установить светиться
Для тех, у кого Snap не установлен или не знает, как он работает, ознакомьтесь с нашим подробным руководством по установка и использование Snap Store в Linux.
Использование Glow для чтения документов Markdown в вашем терминале
Самый простой способ использовать Glow — передать ему файл Markdown в качестве аргумента:
светиться этот-документ.мд
Как видите, Glow отобразил сложный в других отношениях документ, выделенный полужирным шрифтом и курсивом, текст в кавычках, таблицы, списки и ссылки с якорным текстом.
Это довольно удобно, и Glow также поставляется с терминальным пользовательским интерфейсом. Вы можете активировать его с помощью:
светиться
... и Glow представит вам рекурсивный список локальных файлов Markdown. Вы можете перемещаться по списку с помощью клавиш со стрелками на клавиатуре и нажимать Возвращаться чтобы выбрать один. Удар Esc вернет вас в главное меню.
Вы можете запустить Glow в любом каталоге, добавив путь к каталогу в качестве аргумента:
свечение ~/my/markdown/файл/дамп/
Glow позволяет легко хранить файлы Markdown для быстрого ознакомления позже. Просто откройте любой документ Markdown с помощью Glow TUI и нажмите С на вашей клавиатуре.
В качестве альтернативы, если вы не хотите открывать полный TUI, чтобы спрятать документ Markdown, который находится прямо перед вами, запустите:
светящийся тайник этот-документ.мд
Вы можете найти свои спрятанные статьи из основного TUI, используя Вкладка ключ для перехода на вкладку «тайник».
Используйте Glow для чтения документов Markdown онлайн
Glow отлично работает с файлами GitHub README, и если вы знаете имя нужного репозитория, то:
свечение github.com/charmbracelet/glow
... приведет к получению Glow README с GitHub и отображению в качестве стандартного вывода.
Если ваш файл Markdown находится в другом месте, вы можете использовать:
свечение https://host.tld/file.md
Настройте свечение для отображения уценки в терминале
Glow работает хорошо и попытается определить цветовую схему вашего терминала, прежде чем представить вам отформатированный Markdown. Вы можете изменить настройки по умолчанию, если хотите, и можете выбрать светлую или темную тему с помощью переключателя стиля. -с.
светиться - свет
Или переключитесь в темный режим с помощью:
светиться - темно
Если у вас есть собственная таблица стилей, вы можете легко использовать ее и с Glow:
светиться-смой стиль.json
Glow упрощает визуализацию документов Markdown
Чтение документов Markdown в вашем терминале — это огромное улучшение качества жизни и означает, что вам не нужно тратить системные ресурсы на открытие еще одного приложения или браузера с графическим интерфейсом.
Если вы хотите отдохнуть от чтения длинных документов Markdown, вы также можете искать видео на YouTube со своего терминала!