Prólogo
Markdown es una excelente manera de escribir un artículo pequeño, y a veces texto bastante voluminoso, con formato simple en cursiva e impresión gruesa. Markdown también es bueno para escribir artículos con código fuente incluido. Pero a veces quiero transferirlo a un archivo PDF normal y bien formado sin pérdidas, bailando con una pandereta, y para que no haya problemas durante la conversión, que, por ejemplo, fue mía: no se puede escribir en ruso en los comentarios del código fuente, las líneas que son demasiado largas no se transfieren, pero Se cortan otros problemas menores. Las instrucciones le permitirán configurar rápidamente el convertidor md2pdf sin comprender particularmente cómo funciona. El script para una instalación menos automática se encuentra a continuación en la sección correspondiente.
Instalar TexLive
Por supuesto, puede instalar solo las partes necesarias de este paquete. Pero personalmente, fui francamente flojo para buscar la instalación mínima necesaria de trabajo. Para que todo funcione, instale todo el paquete TexLive. Se llama texlive-full y pesa un poco más de 2 gigabytes, tenga en cuenta este hecho. Ejecutamos el comando:
user@hostname:~$ sudo apt install texlive-full -y
Después de una instalación suficientemente larga, puede continuar con el siguiente paso.
Instalar el convertidor de Pandoc
Pandoc es un paquete de Linux que le permite convertir algunos formatos de texto a otros. Tiene muchas características interesantes que puede familiarizarse en Internet. Solo nos interesa la capacidad de convertir archivos de rebajas a PDF. Compruebe si Pandoc está instalado y, de lo contrario, instálelo. Por ejemplo, así:
user@hostname:~$ dpkg -s pandoc
Si el resultado dice que no está instalado, instale:
user@hostname:~$ sudo apt install pandoc -y
Instalar MD2PDF
Puede pasar a la página del script en GitHub y luego continuar de acuerdo con las instrucciones.
O descargue el archivo , descomprímalo en cualquier carpeta, ábralo en el terminal y siga las instrucciones nuevamente.
Abra una terminal y haga:
git clone https://github.com/melichron/md2pdf.git && cd md2pdf
Luego ejecutar como root, por ejemplo:
sudo ./install.sh
Tenga en cuenta que el script utiliza una utilidad para crear cuadros de diálogo de cola de consola. Si no lo tiene instalado, o si no desea instalarlo, o si desea hacer todo usted mismo, instale texlive-full y pandoc manualmente y siga las instrucciones.
Instale md2pdf para todos los usuarios:
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 md2pdf para el usuario actual:
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
Simplemente abra la carpeta con el archivo Markdown ( some_file.md ) en la Terminal y ejecute el comando:
user@hostname:~$ md2pdf some_file.md
Como resultado, el archivo some_file.md.pdf aparece en la carpeta.
Conclusión
Según el método descrito, puede crear cualquier estilo de archivos PDF; también puede convertir otros formatos en lugar de md, cualquiera que sea compatible con Pandoc. Me atrevo a esperar que algún día esta instrucción sea útil para 3 personas y media.