Prefácio
O Markdown é uma ótima maneira de escrever um artigo pequeno e, às vezes, um texto bastante volumoso, com formatação simples em itálico e letras espessas. O Markdown também é bom para escrever artigos com o código-fonte incluído. Mas, às vezes, quero transferi-lo para um arquivo PDF regular e bem projetado, sem perdas, dançando com um pandeiro, e para que não haja problemas durante a conversão, que, por exemplo, eram meus - você não pode escrever em russo nos comentários do código-fonte, linhas muito longas não são transferidas, mas outros problemas menores são cortados. A instrução permitirá que você configure rapidamente o conversor md2pdf sem entender particularmente como ele funciona. O script para uma instalação menos automática está abaixo na seção apropriada.
Instale o TexLive
Obviamente, você pode instalar apenas as partes necessárias deste pacote. Mas, pessoalmente, eu era francamente preguiçoso em procurar a instalação de trabalho mínima necessária. Para que tudo funcione, instale todo o pacote TexLive. É chamado texlive-full e pesa um pouco mais de 2 gigabytes, lembre-se desse fato. Nós executamos o comando:
user@hostname:~$ sudo apt install texlive-full -y
Após uma instalação suficientemente longa, você pode prosseguir para a próxima etapa.
Instale o Pandoc Converter
Pandoc é um pacote Linux que permite converter alguns formatos de texto para outros. Possui muitos recursos interessantes que você pode se familiarizar na Internet. Estamos interessados apenas na capacidade de converter arquivos de remarcação para PDF. Verifique se o Pandoc está instalado e, se não, instale-o. Por exemplo, assim:
user@hostname:~$ dpkg -s pandoc
Se a saída indicar que não está instalada - instale:
user@hostname:~$ sudo apt install pandoc -y
Instale o MD2PDF
Você pode prosseguir para a página de script no GitHub e prosseguir de acordo com as instruções.
Ou faça o download do arquivo , descompacte-o em qualquer pasta, abra-o no terminal e siga as instruções novamente.
Abra um terminal e faça:
git clone https://github.com/melichron/md2pdf.git && cd md2pdf
Em seguida, execute como root, por exemplo:
sudo ./install.sh
Lembre-se de que o script usa um utilitário para criar caixas de diálogo do console whiptail . Se você não o instalou, não deseja instalá-lo ou deseja fazer tudo sozinho, instale o texlive-full e o pandoc manualmente e siga as instruções.
Instale o md2pdf para todos os usuários:
root@host:~/md2pdf# cp ./src/template.tex $(kpsewhich -expand-var='$TEXMFLOCAL') root@host:~/md2pdf# echo "#!/bin/bash" | tee usr/local/bin/md2pdf root@host:~/md2pdf# echo "pandoc --output=\$1.pdf --from=markdown_github --latex-engine=pdflatex --listings --template=$(kpsewhich -expand-var='$TEXMFLOCAL')/template.tex \$1" | tee -a usr/local/bin/md2pdf root@host:~/md2pdf# chmod 755 /usr/local/bin/md2pdf
Instale o md2pdf para o usuário atual:
user@host:~/md2pdf$ cp ./src/template.tex $(kpsewhich -expand-var='$TEXMFHOME') user@host:~/md2pdf$ echo "#!/bin/bash" | tee ~/.local/bin/md2pdf user@host:~/md2pdf$ echo "pandoc --output=\$1.pdf --from=markdown_github --latex-engine=pdflatex --listings --template=$(kpsewhich -expand-var='$TEXMFHOME')/template.tex \$1" | tee -a ~/.local/bin/md2pdf user@host:~/md2pdf$ chmod 755 ~/.local/bin/md2pdf
Usando md2pdf
Basta abrir a pasta com o arquivo Markdown ( some_file.md ) no Terminal e execute o comando:
user@hostname:~$ md2pdf some_file.md
Como resultado, o arquivo some_file.md.pdf aparece na pasta.
Conclusão
Com base no método descrito, você pode criar qualquer estilo de arquivos PDF; também pode converter outros formatos, em vez de md, compatíveis com Pandoc. Atrevo-me a esperar que um dia essa instrução seja útil para 3 pessoas e meia.