Skip to content

Instantly share code, notes, and snippets.

@LinuxProativo
Created August 17, 2025 20:23
Show Gist options
  • Select an option

  • Save LinuxProativo/fd50f7a52d62adedacf767bc3dbe367f to your computer and use it in GitHub Desktop.

Select an option

Save LinuxProativo/fd50f7a52d62adedacf767bc3dbe367f to your computer and use it in GitHub Desktop.
Como visualizar arquivos Markdown no terminal

📖 Como visualizar arquivos Markdown (.md) no terminal com Glow

O formato Markdown (.md) é muito usado em documentações, anotações e projetos de software. Embora seja apenas texto, é interessante poder renderizá-lo de forma mais bonita no terminal.

O Glow é uma ferramenta de linha de comando que faz exatamente isso: exibe arquivos Markdown com formatação, cores e boa legibilidade.


🔧 Instalação do Glow

O Glow está disponível em várias distribuições Linux, macOS e Windows.

Debian, Ubuntu e derivados

sudo apt install glow

Fedora

sudo dnf install glow

Arch Linux e derivados

sudo pacman -S glow

Instalação manual

Baixe o binário na página de releases do GitHub.


👀 Exemplos de uso

Depois de instalado, você pode visualizar arquivos .md de diferentes formas:

1. Renderizar um arquivo diretamente

glow README.md

➡️ Exibe o arquivo formatado diretamente no terminal.


2. Abrir em modo interativo (pager)

glow -p README.md

➡️ O parâmetro -p (ou --pager) abre o arquivo em modo de navegação. Você pode rolar com as setas, PgUp/PgDn e sair com q.


3. Ajustar largura de exibição ao tamanho do terminal

glow -w $COLUMNS README.md

ou

glow -w $(tput cols) README.md

➡️ O parâmetro -w (ou --width) define a largura da renderização. Usar $COLUMNS ou $(tput cols) garante que o texto se ajuste automaticamente à largura atual do terminal.


4. Mostrar saída em interface TUI com números de linha

glow -tl README.md

➡️ O parâmetro -t (ou --tui) abre o Glow no modo interface interativa (TUI). ➡️ O -l (ou --line-numbers) exibe números de linha no TUI.


📑 Principais parâmetros do Glow

Aqui está um resumo dos flags mais úteis:

Flag Nome longo Função
-a --all Mostra arquivos e diretórios do sistema (apenas no modo TUI).
--config <arquivo> Define o arquivo de configuração (padrão: ~/.config/glow/glow.yml).
-h --help Exibe a ajuda do comando.
-l --line-numbers Mostra números de linha (apenas no modo TUI).
-p --pager Exibe com pager, permitindo navegação pelo conteúdo.
-n --preserve-new-lines Preserva quebras de linha originais na saída.
-s --style <nome> Define o estilo do tema (padrão: auto).
-t --tui Abre no modo interface interativa (TUI).
-v --version Mostra a versão do Glow.
-w --width <número> Define a largura da renderização (0 desabilita).

🚀 Conclusão

Com o Glow, você consegue:

  • Visualizar arquivos Markdown diretamente no terminal.
  • Navegar pelo conteúdo em modo pager ou TUI.
  • Ajustar a largura de exibição para manter a formatação.
  • Usar parâmetros adicionais para personalizar a leitura.

É uma ferramenta leve e prática para quem trabalha bastante com Markdown e quer visualizar esse arquivos pelo terminal.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment