Des lecteurs comme vous aident à soutenir MUO. Lorsque vous effectuez un achat en utilisant des liens sur notre site, nous pouvons gagner une commission d'affiliation. En savoir plus.

Markdown est idéal pour l'écriture et vous permet de formater un document dans n'importe quel éditeur de texte, en utilisant des fonctionnalités riches, notamment des en-têtes, des extraits de code, des caractères gras, italiques, des listes de contrôle, des puces, des tableaux, etc. Mais alors que Markdown est facile à écrire dans un éditeur tel que nano, il n'est pas si facile à lire dans le terminal.

Glow est un utilitaire de ligne de commande qui affiche les documents Markdown tels qu'ils doivent être lus.

Qu'est-ce que Markdown et pourquoi est-il difficile à afficher dans un terminal ?

Markdown est une convention de formatage de texte, et c'est à peu près le contraire d'un Éditeur de type Ce que vous voyez est ce que vous obtenez (WYSIWYG).

Les documents Markdown contiennent une variété de symboles qui montrent comment le texte est censé être formaté sur une page. Ces symboles sont interprétés par un analyseur Markdown et soit affichés dans un lecteur de document, soit convertis en HTML pour être affichés sur le Web.

instagram viewer

C'est parce que Markdown s'appuie sur les symboles interprétés par une application externe que vous pouvez le créer même dans l'éditeur de texte le plus simple. Vous n'avez pas besoin d'un téléchargement MS Office de plusieurs gigaoctets pour créer un document Markdown; vous pouvez le faire dans nano, vim ou Emacs.

L'affichage des documents Markdown est une autre affaire. Bien sûr, vous pouvez les ouvrir à nouveau dans nano, ou vous pouvez utiliser chat pour afficher le contenu du fichier, mais vous ne verrez pas le Markdown rendu comme il se doit pour les lecteurs; vous verrez les symboles de mise en forme à la place.

Pour les utilisateurs qui passent beaucoup de temps cloner des dépôts Git, cela devient vite une corvée. Les fichiers Git README sont généralement des documents Markdown, et diviser votre attention entre le rendu mental d'un document Markdown et la digestion de son contenu signifie que vous pouvez manquer beaucoup.

Bien que vous puissiez utiliser un moteur de rendu GUI Markdown dédié ou consulter le site Web, cela signifie que vous devrez vous défocaliser et quitter votre terminal. Si vous utilisez un VPS ou avez une aversion pour les interfaces graphiques de toutes sortes, vous n'auriez pas de chance.

Glow est un lecteur Markdown basé sur un terminal qui est parfait pour lire la documentation Markdown directement sur la ligne de commande. Vous pouvez l'utiliser pour découvrir des fichiers Markdown et les stocker dans votre collection privée.

Comment installer Glow sous Linux

Bien que Glow ne soit pas disponible dans les référentiels officiels de la plupart des distributions Linux, il est toujours facile de l'installer.

Sur Debian et ses dérivés

Pour installer Glow sur les distributions basées sur Ubuntu et Debian, vous devez d'abord ajouter la clé Glow GPG, puis ajouter son référentiel à la liste des sources de votre système.

Ajoutez la clé à votre trousseau de clés et le référentiel à vos sources en utilisant :

sudo mkdir -p /etc/apt/keyrings
boucle -fsSL https ://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [signé-par=/etc/apt/keyrings/charm.gpg] https ://repo.charm.sh/apt/" | sudo tee /etc/apt/sources.list.d/charm.list

Mettez à jour la liste des packages de votre système, puis installez Glow avec :

sudo apt mise à jour
sudo apt installer briller

Installer Glow sur Fedora

Pour télécharger et installer Glow sur Fedora, RHEL et autres distributions basées sur RPM, exécutez d'abord la commande suivante :

écho '[charme]
nom=Charme
baseurl=https ://repo.charm.sh/yum/
activé=1
gpgcheck=1
gpgkey=https ://repo.charm.sh/yum/gpg.key' | tee sudo /etc/yum.repos.d/charm.repo

Ensuite, installez Glow en tapant :

sudo miam installer briller

Sur Arch Linux et ses dérivés

Vous pouvez installer Glow sur les distributions basées sur Arch en utilisant le gestionnaire de packages par défaut, Pacman.

sudo pacman -S lueur

Installez Glow en un clin d'œil

Si vous avez la chance d'avoir un système pris en charge par le Snap Store propriétaire de Canonical, vous pouvez installer Glow avec :

claquement sudo installer briller

Pour ceux qui n'ont pas installé Snap ou qui ne savent pas comment cela fonctionne, consultez notre guide détaillé sur installation et utilisation de Snap Store sous Linux.

Utiliser Glow pour lire des documents Markdown dans votre terminal

La façon la plus simple d'utiliser Glow est de lui passer un fichier Markdown en argument :

briller ce-document.Maryland

Comme vous pouvez le voir, Glow a rendu un document autrement difficile, avec du gras et de l'italique, du texte cité, des tableaux, des listes et des liens avec un texte d'ancrage.

C'est plutôt sympa, et Glow est également livré avec une interface utilisateur de terminal. Vous pouvez l'activer avec :

briller

... et Glow vous présentera une liste récursive de fichiers Markdown locaux. Vous pouvez parcourir la liste avec les touches fléchées de votre clavier et appuyer sur Retour pour en sélectionner un. Frappe Esc vous ramènera au menu principal.

Vous pouvez lancer Glow dans n'importe quel répertoire en ajoutant le chemin du répertoire en argument :

lueur ~/my/markdown/fichier/dump/

Glow vous permet de stocker facilement des fichiers Markdown pour une référence rapide ultérieurement. Ouvrez simplement n'importe quel document Markdown avec le Glow TUI, et appuyez sur S sur votre clavier.

Alternativement, si vous n'avez pas envie d'ouvrir le TUI complet pour ranger un document Markdown juste devant vous, exécutez :

cachette de lueur ce-document.Maryland

Vous pouvez trouver vos articles cachés à partir du TUI principal, en utilisant le Languette touche pour accéder à l'onglet "stash".

Utilisez Glow pour lire des documents Markdown en ligne

Glow fonctionne parfaitement avec les fichiers GitHub README, et si vous connaissez le nom du référentiel que vous voulez, alors :

briller github.com/charmbracelet/glow

... entraînera la récupération du Glow README à partir de GitHub et son rendu en tant que sortie standard.

Si votre fichier Markdown est ailleurs, vous pouvez utiliser :

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

Personnaliser Glow pour afficher Markdown dans le terminal

Glow fonctionne bien tel quel et tentera de détecter la palette de couleurs de votre terminal avant de vous présenter un Markdown formaté. Vous pouvez modifier les valeurs par défaut si vous le souhaitez et choisir entre un thème clair ou sombre avec le commutateur de style -s.

lueur -s lumière

Ou passez en mode sombre avec :

lueur -s sombre

Si vous avez une feuille de style personnalisée, vous pouvez également l'utiliser facilement avec Glow :

briller-smon style.json

Glow facilite le rendu des documents Markdown

La lecture de documents Markdown dans votre terminal est une énorme amélioration de la qualité de vie et signifie que vous n'avez pas besoin de dépenser des ressources système pour ouvrir une autre application ou un navigateur piloté par l'interface graphique.

Si vous avez envie de faire une pause dans la lecture de longs documents Markdown, vous pouvez également rechercher des vidéos YouTube à partir de votre terminal !