¿Cómo puedo convertir Markdown con sabor a Github a un PDF

Recientemente comencé a aprender Markdown para usar con 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 a PDF. Debe tener un resaltado de sintaxis adecuado y no debe verse horrible. Gracias por cualquier ayuda.

He tenido éxito al usar el agarre para mostrar el marcado en Chrome y luego usar la opción "Guardar como PDF" de Chrome en el cuadro de diálogo Imprimir.

pip install grip  
grip your_markdown.md

grip renderizará el markdown en localhost: 5000 - solo edite y actualice el navegador. Imprima cuando esté listo.

Esto proporcionó una representación más confiable que pandoc y fue más liviano que instalar látex (requerido por pandoc para la generación de pdf).

La impresión no es la línea de comando en esta respuesta, pero aún así resultó más fácil / más confiable (se parecía al 100% a Github para un documento largo que incluye imágenes relativamente vinculadas y resaltado de código).

También puede usar Node.js basado en markdown-pdf

npm install -g markdown-pdf
markdown-pdf /path/to/markdown

Echa un vistazo a pandoc . Tiene resaltado de sintaxis. Es posible que requiera que realice cambios (menores) en su documento, ya que tiene su propio sabor de rebaja y no sé qué tan cerca coincide con el sabor de GitHub.

Si el archivo de rebajas se alojó en el repositorio de github, gitprint es una opción interesante para crear pdf / print.

Todo lo que necesitas hacer es reemplazar github.compor gitprint.comen la URL. Aquí hay un ejemplo de la página de inicio de gitprint.

Desafortunadamente, no funciona en las listas de reducción, y solo funciona con archivos de reducción en el repositorio.

Hay un convertidor en línea disponible en http://www.markdowntopdf.com.
Esto proporciona resaltado de sintaxis de fábrica 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, tablas.

Como dije en mi comentario, Github usa Linguist para proporcionar resaltado de sintaxis. En Github, puede usar esto para especificar el resaltado de sintaxis de esta manera:

```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```

Desafortunadamente, no hay una buena manera de convertir Markdown directamente en un archivo PDF con resaltado de sintaxis.

Alternativas:

Vim :

Si tiene vim, puede lograr 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 se puede convertir a pdf usando, por ejemplo, ps2pdf:

ps2pdf /path/to/file.ps

Fuente destacada :

Si en su lugar desea seguir la ruta de HTML o LaTeX, puede probar Source-highlight en su lugar. Aquí puede encontrar una lista de todos los idiomas admitidos por Source-highlight .

Algunos ejemplos de comandos de resaltado de fuente 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 saca su propio archivo HTML respectivo:

Hello1.html
Hello2.html
Hello3.html

Aquí se pueden encontrar más ejemplos de uso de resaltado de fuente

Ventanas :

Vim , ps2pdf (proporcionado por Ghostscript ) y Source-highlight están disponibles a través de Cygwin .

Para aquellos con Linux, use pandoc .

Instalar en pc:

sudo apt install pandoc texlive-latex-extra

Sí, necesitas un -extrapaquete debido a las fuentes.

Convertir:

pandoc --from markdown -o output.pdf my-file.md

Recientemente he creado un servicio para convertir documentos de rebajas a PDF. Es compatible con la reducción de sabor de Github, así como el resaltado de sintaxis. El servicio se encuentra en: http://markdown2pdf.com

Solución minera: convierta markdown con pandoca html (no olvide usar css para pandoc para mostrar los bordes de la tabla) , luego ábralo con libreoffice, elija una opción export as pdf.

NB : ninguna de las soluciones mencionadas aquí y en Internet funcionó para mí: 1) las soluciones basadas en navegador (es decir, grip) están agregando información en exceso, como números de página, que no pude eliminar, 2) la conversión de pandoc a pdf es roto, 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, gitprint.com) también están agregando cosas redundantes, como márgenes similares a github, mientras que ¡Solo necesito una tabla simple que generé con awk!

He probado varios complementos de Chrome y convertidores en línea.
MDtr2PDF es el mejor. Es compatible con Github-con sabor-markdown y unicode.

Refiné 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/md2pdfy sudo chmod +x /usr/local/bin/md2pdfdespués.

Uso:

• md2pdf convierte README.md a README.md.pdf

• md2pdf foo.md convierte foo.md en foo.md.pdf

• md2pdf foo.md bar.pdf convierte foo.md a bar.pdf