Leitores como você ajudam a apoiar o MUO. Quando você faz uma compra usando links em nosso site, podemos ganhar uma comissão de afiliado. Consulte Mais informação.

Markdown é ótimo para escrever e permite formatar um documento em qualquer editor de texto, usando recursos avançados, incluindo títulos, extrações de código, negrito, itálico, listas de verificação, marcadores, tabelas e muito mais. Mas enquanto o Markdown é fácil de escrever em um editor como o nano, não é tão fácil de ler no terminal.

Glow é um utilitário de linha de comando que exibe documentos Markdown da maneira que devem ser lidos.

O que é Markdown e por que é difícil exibi-lo em um terminal?

Markdown é uma convenção para formatar texto, e é praticamente o oposto de um Editor de tipo O que você vê é o que você obtém (WYSIWYG).

Os documentos Markdown contêm uma variedade de símbolos que mostram como o texto deve ser formatado em uma página. Esses símbolos são interpretados por um analisador Markdown e exibidos em um leitor de documentos ou convertidos em HTML para serem exibidos na web.

instagram viewer

É porque o Markdown depende dos símbolos sendo interpretados por um aplicativo externo que você pode criá-lo até mesmo no editor de texto mais simples. Você não precisa de um download do MS Office de vários gigabytes para criar um documento Markdown; você pode fazer isso no nano, vim ou Emacs.

A exibição de documentos Markdown é uma questão diferente. Claro, você pode abri-los no nano novamente ou pode usar gato para visualizar o conteúdo do arquivo, mas você não verá o Markdown renderizado como deveria ser para os leitores; você verá os símbolos de formatação.

Para usuários que passam muito tempo clonando repositórios Git, isso rapidamente se torna uma tarefa árdua. Os arquivos Git README são tipicamente documentos Markdown, e dividir sua atenção entre renderizar mentalmente um documento Markdown e digerir seu conteúdo significa que você pode perder muito.

Embora você possa usar um renderizador GUI Markdown dedicado ou verificar o site, isso significa que você teria que desfocar e deixar seu terminal. Se você estiver usando um VPS ou tiver aversão a GUIs de qualquer tipo, estará sem sorte.

O Glow é um leitor de Markdown baseado em terminal, perfeito para ler a documentação do Markdown diretamente na linha de comando. Você pode usá-lo para descobrir arquivos Markdown e armazená-los em sua coleção particular.

Como instalar o Glow no Linux

Embora o Glow não esteja disponível nos repositórios oficiais da maioria das distribuições Linux, ainda é fácil instalá-lo.

Sobre o Debian e seus derivados

Para instalar o Glow em distribuições baseadas em Ubuntu e Debian, primeiro você precisa adicionar a chave Glow GPG e, em seguida, adicionar seu repositório à lista de fontes do seu sistema.

Adicione a chave ao seu chaveiro e o repositório às suas fontes usando:

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 [assinado por =/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/" | sudo tee /etc/apt/sources.list.d/charm.list

Atualize a lista de pacotes do seu sistema e instale o Glow com:

sudo apt atualizar
sudo apt instalar brilho

Instale o Glow no Fedora

Para baixar e instalar o Glow no Fedora, RHEL e outras distros baseadas em RPM, execute o seguinte comando primeiro:

eco '[charme]
nome=Charme
baseurl=https://repo.charm.sh/yum/
habilitado=1
gpgcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repo

Em seguida, instale o Glow digitando:

sudo yum instalar brilho

Sobre o Arch Linux e seus derivados

Você pode instalar Glow em distribuições baseadas em Arch usando o gerenciador de pacotes padrão, Pacman.

sudo pacman -S brilho

Instale o Glow como um Snap

Se você tiver a sorte de ter um sistema compatível com a Snap Store proprietária da Canonical, poderá instalar o Glow com:

sudo snap instalar brilho

Para quem não tem o Snap instalado ou não sabe como funciona, confira nosso guia detalhado sobre instalando e usando o Snap Store no Linux.

Usando o Glow para ler documentos Markdown em seu terminal

A maneira mais direta de usar o Glow é passar a ele um arquivo Markdown como argumento:

brilho esse-documento.md

Como você pode ver, o Glow renderizou um documento difícil, completo com negrito e itálico, texto entre aspas, tabelas, listas e links com texto âncora.

Isso é muito legal, e o Glow também vem com uma interface de usuário de terminal. Você pode ativá-lo com:

brilho

...e o Glow apresentará uma lista recursiva de arquivos Markdown locais. Você pode navegar na lista com as teclas de seta do teclado e clicar Retornar para selecionar um. Batendo Esc retornará ao menu principal.

Você pode iniciar o Glow em qualquer diretório adicionando o caminho do diretório como um argumento:

brilho ~/my/markdown/file/dump/

O Glow facilita o armazenamento de arquivos Markdown para referência rápida posteriormente. Basta abrir qualquer documento Markdown com o Glow TUI e clicar S em seu teclado.

Alternativamente, se você não quiser abrir a TUI completa para esconder um documento Markdown bem na sua frente, execute:

estoque de brilho esse-documento.md

Você pode encontrar seus artigos armazenados na TUI principal, usando o Aba para navegar até a guia "stash".

Use o Glow para ler documentos Markdown online

O Glow funciona perfeitamente com os arquivos README do GitHub, e se você souber o nome do repositório que deseja, então:

brilho github.com/charmbracelet/glow

... resultará no Glow README sendo obtido do GitHub e renderizado como saída padrão.

Se o seu arquivo Markdown estiver em outro lugar, você pode usar:

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

Personalize o brilho para exibir Markdown no terminal

O Glow funciona bem como está e tentará detectar o esquema de cores do terminal antes de apresentar o Markdown formatado. Você pode alterar os padrões se desejar e pode escolher entre um tema claro ou escuro com a opção de estilo -s.

brilho -s luz

Ou mude para o modo escuro com:

brilho - escuro

Se você tiver uma folha de estilo personalizada, também poderá usá-la facilmente com o Glow:

brilho-smeu estilo.json

Glow facilita a renderização de documentos Markdown

A leitura de documentos Markdown em seu terminal é uma grande melhoria na qualidade de vida e significa que você não precisa gastar recursos do sistema abrindo outro aplicativo ou navegador orientado por GUI.

Se você gosta de fazer uma pausa na leitura de longos documentos Markdown, também pode pesquisar vídeos do YouTube em seu terminal!