Recientemente he empezado a aprender Markdown para utilizarlo en la documentación, y necesito imprimir algunas de mis páginas de Markdown. Me gustaría utilizar una utilidad de línea de comandos, Terminal, etc. que me permita convertir Markdown con sabor a Github en PDF. Tiene que tener un resaltado de sintaxis adecuado y no debe tener un aspecto horrible. Gracias por cualquier ayuda.
He tenido éxito usando grip para mostrar markdown en Chrome y luego usar la opción “Guardar como PDF” de Chrome en el diálogo de impresión.
pip install grip
grip your_markdown.md
grip renderizará el markdown en localhost:5000 - simplemente edita y refresca el navegador. Imprima cuando esté listo.
Esto dio una representación más fiable que pandoc y fue más ligero que instalar latex (requerido por pandoc para la generación de pdf).
La impresión no es de línea de comandos en esta respuesta, pero aún así encontré esto más fácil/más confiable (se veía 100% como Github para un documento largo incluyendo imágenes relativamente enlazadas y resaltado de código).
También puede utilizar Node.js basado en markdown-pdf
npm install -g markdown-pdf
markdown-pdf /path/to/markdown
Si el archivo markdown fue alojado en el repositorio github, gitprint es una opción interesante para crear pdf / imprimir.
Lo único que hay que hacer es sustituir github.com por gitprint.com en la URL. Aquí hay un ejemplo de la página web de gitprint.
Desafortunadamente, no funciona con gists de markdown, y sólo funciona con archivos de markdown en el repositorio.
Hay un convertidor en línea disponible en http://www.markdowntopdf.com Esto proporciona resaltado de sintaxis fuera de la caja y es la solución más simple que he visto hasta ahora. También maneja correctamente otras características específicas de GFM, por ejemplo, las tablas.
Como dije en mi comentario, Github utiliza Linguist para proporcionar el resaltado de sintaxis. En Github, puedes usar esto para especificar el resaltado de sintaxis así
```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
Desafortunadamente, no hay una buena manera de convertir Markdown directamente a un archivo PDF con resaltado de sintaxis.
### Alternativas:
**Vim** :
Si tienes vim, puedes conseguir fácilmente el resaltado de sintaxis ejecutando lo siguiente desde un terminal:
vim -c hardcopy -c quit /path/to/file.ps “`
O dentro de vim:
:hardcopy >/path/to/file.ps
Esto producirá un archivo PostScript que puede ser convertido a pdf usando, por ejemplo, ps2pdf:
ps2pdf /path/to/file.ps
Source-highlight :
Si en lugar de eso quiere seguir el camino de HTML o LaTeX, puede intentar Source-highlight en su lugar. Puede encontrar una lista de todos los lenguajes soportados por Source-highlight aquí .
Algunos ejemplos de comandos de Source-highlight incluyen:
source-highlight -s java -f html -i Hello.java -o Hello1.html
source-highlight -s java -f html --input Hello.java --output Hello2.html --doc
source-highlight -s java -f html -i Hello.java -o Hello3.html --title "Happy Java with java2html :-)" --tab 3
Usando este archivo de entrada
Y cada uno emitiendo su propio archivo HTML respectivo: Hola1.html Hola2.html Hola3.html
Más ejemplos de uso de Source-highlight pueden encontrarse aquí
Windows : Vim , ps2pdf (proporcionado por Ghostscript ) y Source-highlight están disponibles a través de Cygwin .
Para los que tienen Linux, utilice pandoc .
Instalar:
sudo apt install pandoc texlive-latex-extra
Sí, necesita el paquete -extra debido a las fuentes.
Convertir:
pandoc --from markdown -o output.pdf my-file.md
Recientemente he creado un servicio para convertir documentos markdown a PDF. Soporta markdown con sabor a Github, así como resaltado de sintaxis. El servicio se encuentra en: http://markdown2pdf.com
Yo tuve más suerte con VSCode y la extensión Markdown PDF . Los convertidores en línea arruinaron la codificación de mis archivos o insertaron marcas de agua en el encabezado.
Uso:
export y seleccione markdown-pdf: Export (pdf) NB: La extensión instala y utiliza una versión local de Chromium en segundo plano.
Hay varias opciones para controlar el formato, todas ellas se explican en la página web enlazada anteriormente
He refinado este fragmento para mis necesidades personales:
# sudo apt install grip wkhtmltopdf
MD=${1:-README.md}
PDF=${2:-"$MD".pdf}
PORT=8971
DELAY=10
printf "Converting $MD to $PDF on port $PORT\n"
printf "Waiting $DELAY seconds for server to start...\n"
grip "$MD" localhost:$PORT &
sleep $DELAY
wkhtmltopdf http://localhost:$PORT "$PDF"
kill $(ps -eo pid,command | grep grip | grep -v grep | awk '{print $1}')
Guardar como /usr/local/bin/md2pdf y sudo chmod +x /usr/local/bin/md2pdf después.
Uso:
md2pdf convierte README.md en README.md.pdf
md2pdf foo.md convierte foo.md en foo.md.pdf
Mi solución: convertir el markdown con pandoc a html (no olvidar usar css para pandoc para mostrar los bordes de la tabla), luego abrirlo con libreoffice, elegir una opción export as pdf.
NB : ninguna de las soluciones mencionadas aquí y en Internet me han funcionado: 1) las soluciones basadas en el navegador (es decir, grip) añaden un exceso de información, como los números de página, que no he conseguido eliminar, 2) la conversión de pandoc a pdf está rota, para mí genera una tabla vacía (quizás debido a unicode, y sí, lo configuré para usar xetex), 3) las soluciones basadas en el sitio (es decir. e. gitprint.com) también añaden cosas redundantes, como márgenes tipo github, mientras que yo sólo necesito una simple tabla generada con awk.