Jak czytać dokumenty Markdown w terminalu Linux z blaskiem

Markdown doskonale nadaje się do pisania i umożliwia formatowanie dokumentu w dowolnym edytorze tekstu, przy użyciu bogatych funkcji, takich jak nagłówki, fragmenty kodu, pogrubienie, kursywa, listy kontrolne, wypunktowania, tabele i inne. Ale chociaż Markdown jest łatwy do napisania w edytorze, takim jak nano, nie jest tak łatwy do odczytania w terminalu.

Glow to narzędzie wiersza poleceń, które wyświetla dokumenty Markdown w sposób, w jaki powinny być czytane.

Co to jest Markdown i dlaczego trudno go wyświetlić w terminalu?

Markdown to konwencja formatowania tekstu, która jest prawie przeciwieństwem edytora typu What You See Is What You Get (WYSIWYG).

Dokumenty Markdown zawierają różne symbole, które pokazują, jak tekst powinien być sformatowany na stronie. Symbole te są interpretowane przez parser Markdown i wyświetlane w czytniku dokumentów lub konwertowane do formatu HTML, który ma być wyświetlany w Internecie.

Ponieważ Markdown opiera się na symbolach interpretowanych przez zewnętrzną aplikację, możesz go utworzyć nawet w najprostszym edytorze tekstu. Nie potrzebujesz wielogigabajtowego pakietu MS Office do pobrania, aby utworzyć dokument Markdown; możesz to zrobić w nano, vimie lub Emacsie.

Wyświetlanie dokumentów Markdown to inna sprawa. Jasne, możesz ponownie otworzyć je w nano lub użyć cat , aby wyświetlić zawartość pliku, ale nie zobaczysz, że Markdown jest renderowany tak, jak powinien być dla czytelników; zamiast tego zobaczysz symbole formatowania.

Dla użytkowników, którzy spędzają dużo czasu na klonowaniu repozytoriów Git, szybko staje się to przykrym obowiązkiem. Pliki README Git to zazwyczaj dokumenty Markdown, a dzielenie uwagi między mentalne renderowanie dokumentu Markdown i trawienie jego treści oznacza, że ​​możesz wiele przegapić.

Chociaż możesz użyć dedykowanego renderera GUI Markdown lub sprawdzić stronę internetową, oznacza to, że będziesz musiał rozogniskować i opuścić terminal. Jeśli używasz VPS lub masz awersję do jakiegokolwiek GUI, nie masz szczęścia.

Glow to terminalowy czytnik Markdown, który idealnie nadaje się do czytania dokumentacji Markdown bezpośrednio w wierszu poleceń. Możesz go użyć do odkrywania plików Markdown i przechowywania ich w swojej prywatnej kolekcji.

Jak zainstalować Glow w systemie Linux

Chociaż Glow nie jest dostępny w większości oficjalnych repozytoriów dystrybucji Linuksa, nadal jest łatwy do zainstalowania.

O Debianie i jego pochodnych

Aby zainstalować Glow w dystrybucjach opartych na Ubuntu i Debianie, najpierw musisz dodać klucz Glow GPG, a następnie dodać jego repozytorium do listy źródeł systemu.

Dodaj klucz do swojego pęku kluczy i repozytorium do swoich źródeł, używając:

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

Zaktualizuj listę pakietów swojego systemu, a następnie zainstaluj Glow za pomocą:

sudo apt update
sudo apt install glow

Zainstaluj Glow na Fedorze

Aby pobrać i zainstalować Glow w Fedorze, RHEL i innych dystrybucjach opartych na RPM, najpierw uruchom następujące polecenie:

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

Następnie zainstaluj Glow, wpisując:

sudo yum install glow

O Arch Linux i jego pochodnych

Możesz zainstalować Glow w dystrybucjach opartych na Arch, używając domyślnego menedżera pakietów, Pacman.

sudo pacman -S glow

Zainstaluj Glow w mgnieniu oka

Jeśli masz szczęście i masz system obsługiwany przez Snap Store firmy Canonical, możesz zainstalować Glow za pomocą:

sudo snap install glow

Dla tych, którzy nie mają zainstalowanego Snap lub nie wiedzą, jak to działa, zapoznaj się z naszym szczegółowym przewodnikiem na temat instalowania i używania Snap Store w systemie Linux.

Używanie blasku do czytania dokumentów Markdown w twoim terminalu

Najprostszym sposobem użycia Glow jest przekazanie mu pliku Markdown jako argumentu:

glow this-document.md

Jak widać, Glow wyrenderował dokument, który skądinąd był trudny, wraz z pogrubieniem i kursywą, cytowanym tekstem, tabelami, listami i linkami z tekstem zakotwiczenia.

To całkiem fajne, a Glow jest również wyposażony w terminalowy interfejs użytkownika. Możesz go aktywować za pomocą:

glow

… a Glow przedstawi ci rekurencyjną listę lokalnych plików Markdown. Możesz poruszać się po liście za pomocą klawiszy strzałek na klawiaturze i nacisnąć Return , aby wybrać jeden. Naciśnięcie Esc spowoduje powrót do menu głównego.

Możesz uruchomić Glow w dowolnym katalogu, dodając ścieżkę do katalogu jako argument:

glow ~/my/markdown/file/dump/

Glow ułatwia przechowywanie plików Markdown do szybkiego wykorzystania w przyszłości. Po prostu otwórz dowolny dokument Markdown za pomocą Glow TUI i naciśnij S na klawiaturze.

Alternatywnie, jeśli nie masz ochoty otwierać pełnego TUI, aby schować dokument Markdown, który jest tuż przed tobą, uruchom:

glow stash this-document.md

Możesz znaleźć swoje ukryte artykuły z głównego TUI, używając klawisza Tab , aby przejść do zakładki „schowek”.

Użyj blasku, aby czytać dokumenty Markdown online

Glow doskonale współpracuje z plikami README GitHub, a jeśli znasz nazwę repozytorium, które chcesz, to:

glow github.com/charmbracelet/glow

…spowoduje pobranie Glow README z GitHub i wyrenderowanie jako standardowe wyjście.

Jeśli twój plik Markdown znajduje się gdzie indziej, możesz użyć:

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

Dostosuj poświatę, aby wyświetlić przecenę w terminalu

Glow działa dobrze i spróbuje wykryć schemat kolorów terminala przed przedstawieniem sformatowanego Markdown. Jeśli chcesz, możesz zmienić ustawienia domyślne i wybrać jasny lub ciemny motyw za pomocą przełączników stylu -s .

glow -s light

Lub przełącz się na tryb ciemny za pomocą:

glow -s dark

Jeśli masz niestandardowy arkusz stylów, możesz go łatwo używać również z Glow:

glow -s mystyle.json

Blask ułatwia renderowanie dokumentów Markdown

Czytanie dokumentów Markdown w twoim terminalu to ogromna poprawa jakości życia i oznacza, że ​​nie musisz wydawać zasobów systemowych na otwieranie kolejnej aplikacji lub przeglądarki opartej na GUI.

Jeśli masz ochotę zrobić sobie przerwę od czytania długich dokumentów Markdown, możesz też wyszukiwać filmy z YouTube na swoim terminalu!