Markdown es excelente para escribir y le permite dar formato a un documento en cualquier editor de texto, utilizando funciones avanzadas que incluyen encabezado, extractos de código, negrita, cursiva, listas de verificación, viñetas, tablas y más. Pero mientras Markdown es fácil de escribir en un editor como nano, no es tan fácil de leer en la terminal.
Glow es una utilidad de línea de comandos que muestra los documentos de Markdown de la forma en que deben leerse.
¿Qué es Markdown y por qué es difícil mostrarlo en una terminal?
Markdown es una convención para formatear texto, y es más o menos lo contrario de un Editor de tipos Lo que ves es lo que obtienes (WYSIWYG).
Los documentos de Markdown contienen una variedad de símbolos que muestran cómo se supone que debe formatearse el texto en una página. Estos símbolos son interpretados por un analizador de Markdown y se muestran en un lector de documentos o se convierten a HTML para que se muestren en la web.
Debido a que Markdown depende de que los símbolos sean interpretados por una aplicación externa, puede crearlos incluso en el editor de texto más simple. No necesita una descarga de MS Office de varios gigabytes para crear un documento Markdown; puedes hacerlo en nano, vim o Emacs.
Mostrar documentos de Markdown es un asunto diferente. Claro, puede abrirlos en nano nuevamente, o puede usar gato para ver el contenido del archivo, pero no verá el Markdown representado como debería ser para los lectores; verá los símbolos de formato en su lugar.
Para usuarios que pasan mucho tiempo clonación de repositorios Git, esto se convierte rápidamente en una tarea. Los archivos README de Git suelen ser documentos de Markdown, y dividir su atención entre renderizar mentalmente un documento de Markdown y digerir su contenido significa que puede perderse mucho.
Si bien podría usar un renderizador Markdown de GUI dedicado, o consultar el sitio web, esto significa que tendría que desenfocar y abandonar su terminal. Si está utilizando un VPS o tiene aversión a las GUI de cualquier tipo, no tendrá suerte.
Glow es un lector de Markdown basado en terminal que es perfecto para leer la documentación de Markdown directamente en la línea de comandos. Puede usarlo para descubrir archivos Markdown y guardarlos en su colección privada.
Cómo instalar Glow en Linux
Aunque Glow no está disponible en los repositorios oficiales de la mayoría de las distribuciones de Linux, aún es fácil de instalar.
Sobre Debian y sus derivados
Para instalar Glow en distribuciones basadas en Ubuntu y Debian, primero debe agregar la clave Glow GPG y luego agregar su repositorio a la lista de fuentes de su sistema.
Agregue la clave a su conjunto de claves y el repositorio a sus fuentes usando:
sudo mkdir -p /etc/apt/llaveros
enrollamiento -fsSL https://repo.charm.sh/apt/gpg.clave | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [firmado por =/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/" | sudo tee /etc/apt/sources.list.d/charm.list
Actualice la lista de paquetes de su sistema, luego instale Glow con:
sudo apto actualizar
sudo apto instalar brillo
Instalar Glow en Fedora
Para descargar e instalar Glow en Fedora, RHEL y otras distribuciones basadas en RPM, ejecuta primero el siguiente comando:
eco '[encanto]
nombre=encanto
baseurl=https://repo.charm.sh/yum/
habilitado=1
gpcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.clave' | sudo tee /etc/yum.repos.d/charm.repo
Luego, instala Glow escribiendo:
sudo mmm instalar brillo
Sobre Arch Linux y sus derivados
Puede instalar Glow en distribuciones basadas en Arch utilizando el administrador de paquetes predeterminado, Pacman.
sudo pacman -S brillo
Instalar Glow como un complemento
Si tiene la suerte de tener un sistema compatible con Snap Store propiedad de Canonical, puede instalar Glow con:
complemento sudo instalar brillo
Para aquellos que no tienen Snap instalado o no saben cómo funciona, consulte nuestra guía detallada sobre instalar y usar Snap Store en Linux.
Uso de Glow para leer documentos Markdown en su terminal
La forma más sencilla de usar Glow es pasarle un archivo Markdown como argumento:
brillo este-documento.Maryland
Como puede ver, Glow representó un documento que de otro modo sería difícil, completo con negritas y cursivas, texto citado, tablas, listas y enlaces con texto ancla.
Eso es bastante bueno, y Glow también viene con una interfaz de usuario de terminal. Puedes activarlo con:
brillo
...y Glow le presentará una lista recursiva de archivos Markdown locales. Puede navegar por la lista con las teclas de flecha del teclado y pulsar Devolver para seleccionar uno. Golpear Esc lo regresará al menú principal.
Puede iniciar Glow en cualquier directorio agregando la ruta del directorio como argumento:
resplandor ~/my/markdown/archivo/volcado/
Glow le facilita guardar archivos de Markdown para una referencia rápida más adelante. Simplemente abra cualquier documento de Markdown con Glow TUI y presione S en tu teclado.
Alternativamente, si no desea abrir la TUI completa para ocultar un documento de Markdown que está justo frente a usted, ejecute:
escondite brillante este-documento.Maryland
Puede encontrar sus artículos ocultos desde la TUI principal, utilizando el Pestaña para navegar a la pestaña "alijo".
Use Glow para leer documentos Markdown en línea
Glow funciona perfectamente con archivos README de GitHub, y si conoce el nombre del repositorio que desea, entonces:
brillo github.com/charmbracelet/glow
... dará como resultado que Glow README se obtenga de GitHub y se represente como salida estándar.
Si su archivo Markdown está en otro lugar, puede usar:
resplandor https://host.tld/file.md
Personalizar Resplandor para Mostrar Markdown en la Terminal
Glow funciona bien tal como está e intentará detectar el esquema de color de su terminal antes de presentarle Markdown formateado. Puede cambiar los valores predeterminados si lo desea y puede elegir entre un tema claro u oscuro con el interruptor de estilo -s.
resplandor -s luz
O cambia al modo oscuro con:
brillo -s oscuro
Si tiene una hoja de estilo personalizada, también puede usarla fácilmente con Glow:
brillo-smi estilo.json
Glow facilita la representación de documentos Markdown
Leer documentos de Markdown en su terminal es una gran mejora en la calidad de vida y significa que no necesita gastar recursos del sistema abriendo otra aplicación o navegador controlado por GUI.
Si te apetece tomarte un descanso de leer largos documentos de Markdown, ¡también puedes buscar videos de YouTube desde tu terminal!