Parser de markdown para destaques e cores do terminal.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Blau Araujo ff9578cff1 Merge pull request 'Revisão, typos' (#1) from tico/md2term:main into main 4 months ago
en Adiciona traduções 4 months ago
screenshot pasta de screenshot renomeada 5 months ago
test preparation for tranlation 4 months ago
themes html entities decode 5 months ago
LICENSE licença 4 months ago
MANUAL.md Revisão, typos 4 months ago
Makefile corrigido diretório do tema padrão 4 months ago
README.md Revisão, typos 4 months ago
md2term corrigido diretório do tema padrão 4 months ago
md2term.1 man page 4 months ago

README.md

md2term

Parser de markdown para destaques e cores do terminal.

Objetivo

O md2term foi criado para ser um parser de markdown para textos curtos (menos de 30 linhas) que pudessem ser utilizados em apresentações pelo terminal (slides em texto) e, ao mesmo tempo, capazes de serem visualizados corretamente por outros parsers em sites na web (GitHub, GitLab, etc). O script também pode ser utilizado satisfatoriamente para visualizar outros textos em markdown, desde que observadas suas limitações.

Uso

md2term [OPÇÕES] -f ARQUIVO

OPÇÕES:

    -b CARACTERE     Caractere marcador de listas.

    -c               Limpa o terminal antes de exibir o texto.

    -i ESPAÇOS       Indentação de listas, códigos e citações em espaços.

    -k VALOR         Manter as cerquilhas nos títulos:
                     0=Descarta todas 1=Mantém todas 2=Apenas no título 1

    -m ESPAÇOS       Recuo da margem esquerda em espaços.

    -p               Carrega em um pager (less).

    -s ARQUIVO       Esquema de cores alternativo.

    -t LINHAS        Afastamento do topo em linhas.

    -h               Exibe esta ajuda.

Dependências

Instalação

Clone o repositório:

git clone https://codeberg.org/blau_araujo/md2term

Entre no diretório md2term que foi criado e execute o make:

cd /caminho/para/md2term
sudo make install

Para desinstalar:

cd /caminho/para/md2term
sudo make uninstall

Marcações válidas

Marcação Resultado
**TEXTO** ou __TEXTO__ NEGRITO
*TEXTO* ou *TEXTO* ITÁLICO
___TEXTO___ ou ***TEXTO*** NEGRITO E ITÁLICO
~~TEXTO~~ RISCADO
<u>TEXTO</u> SUBLINHADO
`TEXTO` CÓDIGO NA LINHA
[RÓTULO](URL) RÓTULO

Blocos

Bloco de código

```
BLOCO DE CÓDIGO
```

Listas não ordenadas

- Item 1
- Item 2
- Item 3

Listas ordenadas

1. Item 1
1. Item 2
1. Item 3

Citações/notas

> O texto da citação ou da nota.

Forçar quebra de linha

Parágrafos, itens de lista e citações podem \
ter suas linhas quebradas onde desejado \
utilizando contrabarras.

Limitações

  • Não interpreta listas aninhadas (sub-itens) corretamente.
  • As quebras de linhas longas podem acontecer no meio de palavras, mas é possível contornar o problema especificando onde elas devem acontecer no texto fonte (é uma marcação válida do markdown GFM).
  • Utilizar as opções -c e -p em conjunto pode levar a problemas de redesenho do buffer no less.
  • Links são apenas representações visuais utilizando o rótulo da marcação (não a URL). Se preferir a URL, ela pode ser usada como rótulo ou ser escrita como texto sem marcação (a maioria dos terminais interpreta URLs como link).

Licença

Copyright (C) 2022 Blau Araujo blau@debxp.org

Licença GPLv3+: GNU GPL versão 3 ou posterior https://gnu.org/licenses/gpl.html
Este é um software livre: você é livre para alterá-lo e redistribuí-lo.
NÃO HÁ QUALQUER GARANTIA, na máxima extensão permitida em lei.

Desenvolvido por Blau Araujo e Romeu Alfa