Come posso convertire markdown al gusto di Github in PDF

Di recente ho iniziato a studiare Markdown per l'uso con la documentazione e devo stampare alcune delle mie pagine Markdown. Vorrei utilizzare un'utilità da riga di comando, Terminale, ecc. Che mi consente di convertire Markdown in formato Github in PDF. Deve avere una corretta evidenziazione della sintassi e non dovrebbe apparire orribile. Grazie per qualsiasi aiuto.

Ho avuto successo usando grip per visualizzare il markdown in Chrome e quindi usare l'opzione "Salva come PDF" di Chrome nella finestra di dialogo Stampa.

pip install grip  
grip your_markdown.md

grip renderà il markdown su localhost: 5000 - basta modificare e aggiornare il browser. Stampa quando pronto.

Ciò ha fornito una rappresentazione più affidabile di Pandoc ed è stato più leggero rispetto all'installazione di lattice (richiesto da PandC per la generazione di pdf).

La stampa non è una riga di comando in questa risposta, ma lo ha ancora trovato più facile / più affidabile (sembrava Github al 100% per un lungo documento che includeva immagini relativamente collegate e l'evidenziazione del codice).

Puoi anche usare markdown -pdf basato su Node.js

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

Dai un'occhiata a Pandoc . Ha l'evidenziazione della sintassi. Potrebbe essere necessario apportare modifiche (minori) al documento poiché ha il proprio sapore di markdown e non so quanto corrisponda al sapore di GitHub.

Se il file markdown è stato ospitato sul repository github, gitprint è un'interessante opzione per creare pdf / stampa.

Tutto quello che devi fare è sostituirlo github.comcon gitprint.comnell'URL. Ecco un esempio dalla homepage di gitprint.

Sfortunatamente, non funziona con i markdown e funziona solo con i file markdown nel repository.

C'è un convertitore online disponibile su http://www.markdowntopdf.com
Questo fornisce l'evidenziazione della sintassi pronta all'uso ed è la soluzione più semplice che abbia mai visto finora. Gestisce inoltre correttamente altre funzionalità specifiche di GFM, ad esempio le tabelle.

Come ho affermato nel mio commento, Github utilizza Linguist per fornire l'evidenziazione della sintassi. Su Github, puoi usarlo per specificare l'evidenziazione della sintassi in questo modo:

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

Sfortunatamente, non esiste un buon modo per convertire Markdown direttamente in un file PDF con l'evidenziazione della sintassi.

alternative:

Vim :

Se hai vim, puoi facilmente ottenere l'evidenziazione della sintassi eseguendo quanto segue da un terminale:

vim -c hardcopy -c quit /path/to/file.ps

O all'interno di Vim:

:hardcopy >/path/to/file.ps

Questo produrrà un file PostScript che può essere convertito in pdf usando, ad esempio, ps2pdf:

ps2pdf /path/to/file.ps

Punto culminante della fonte :

Se invece preferisci seguire il percorso di HTML o LaTeX, puoi invece provare Source-highlight . Un elenco di tutte le lingue supportate da Source-highlight è disponibile qui .

Alcuni comandi di evidenziazione della sorgente di esempio includono:

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

Utilizzando questo file di input

E ognuno in uscita il proprio rispettivo file HTML:

Hello1.html
Hello2.html
Hello3.html

Ulteriori esempi di utilizzo dell'evidenziazione della fonte sono disponibili qui

Windows :

Vim , ps2pdf (fornito da Ghostscript ) e Source-highlight sono tutti disponibili tramite Cygwin .

Per quelli con Linux, usa pandoc .

Installare:

sudo apt install pandoc texlive-latex-extra

Sì, è necessario il -extrapacchetto a causa dei caratteri.

Convertire:

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

Di recente ho creato un servizio per convertire i documenti di markdown in PDF. Supporta markdown al gusto di Github e evidenziazione della sintassi. Il servizio è disponibile all'indirizzo: http://markdown2pdf.com

La mia soluzione: converti markdown con pandocin html (non dimenticare di usare css per pandoc per mostrare i bordi della tabella) , quindi aprilo con libreoffice, scegli un'opzione export as pdf.

NB : nessuna delle soluzioni menzionate qui e su Internet ha funzionato per me: 1) le soluzioni basate su browser (ovvero grip) aggiungono informazioni in eccesso, come i numeri di pagina, che non sono riuscito a rimuovere, 2) la conversione pandoc in pdf è rotto, per me genera una tabella vuota (forse a causa dell'unicode, e sì, l'ho configurato per l'uso di xetex) , 3) soluzioni basate sul sito (ad esempio gitprint.com) stanno anche aggiungendo cose ridondanti, come i margini simili a github, mentre Ho bisogno solo di una semplice tabella che ho generato con awk!

Ho provato diversi plugin di Chrome e convertitori online.
MDtr2PDF è il migliore. Supporta markdown e unicode al gusto di Github.

Ho perfezionato questo frammento per le mie esigenze personali:

# 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}')

Salva come /usr/local/bin/md2pdfe in sudo chmod +x /usr/local/bin/md2pdfseguito.

Uso:

• md2pdf converte README.md in README.md.pdf

• md2pdf foo.md converte foo.md in foo.md.pdf

• md2pdf foo.md bar.pdf converte foo.md in bar.pdf