Wie kann ich Github-Flavored Markdown in ein PDF konvertieren?

Ich habe kürzlich angefangen, Markdown für die Verwendung mit Dokumentationen zu lernen und muss einige meiner Markdown-Seiten ausdrucken. Ich möchte eine Befehlszeile, ein Terminal usw.-Dienstprogramm verwenden, mit dem ich Markdown mit Github-Geschmack in PDF konvertieren kann. Es muss die richtige Syntax hervorheben und sollte nicht schrecklich aussehen. Danke für jede Hilfe.

Ich hatte Erfolg mit Grip , um Markdowns in Chrome anzuzeigen und dann die Option "Als PDF speichern" in Chrome im Dialogfeld "Drucken" zu verwenden.

pip install grip  
grip your_markdown.md

grip rendert den Markdown für localhost: 5000 - einfach bearbeiten und den Browser aktualisieren. Drucken Sie, wenn Sie fertig sind.

Dies ergab eine zuverlässigere Darstellung als pandoc und war leichter als die Installation von Latex (für die PDF-Generierung von pandoc erforderlich).

Der Ausdruck ist in dieser Antwort nicht über die Befehlszeile möglich, hat sich jedoch als einfacher / zuverlässiger erwiesen (sah bei einem langen Dokument mit relativ verknüpften Bildern und Hervorhebungen von Code zu 100% wie Github aus).

Sie können auch Node.js basiertes markdown-pdf verwenden

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

Werfen Sie einen Blick auf Pandoc . Es hat Syntaxhervorhebung. Möglicherweise müssen Sie (geringfügige) Änderungen an Ihrem Dokument vornehmen, da es eine eigene Abschrift aufweist und ich nicht weiß, wie genau es mit der GitHub-Variante übereinstimmt.

Wenn die Markdown-Datei im Github-Repository gehostet wurde, ist GITPRINT eine interessante Option zum Erstellen von PDF / Print.

Alles, was Sie tun müssen, ist in der URL github.comdurch zu ersetzen gitprint.com. Hier ist ein Beispiel von der Homepage von gitprint.

Leider funktioniert es nicht mit Markdown-Listen und nur mit Markdown-Dateien im Repository.

Unter http://www.markdowntopdf.com steht ein Online-Konverter zur Verfügung.
Dieser bietet eine sofort einsatzbereite Hervorhebung der Syntax und ist die einfachste Lösung, die ich bisher gesehen habe. Andere GFM-spezifische Funktionen, z. B. Tabellen, werden ebenfalls korrekt verarbeitet.

Wie ich in meinem Kommentar ausgeführt habe, verwendet Github Linguist , um die Syntax hervorzuheben. Auf Github können Sie dies verwenden, um die Syntaxhervorhebung wie folgt festzulegen:

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

Leider gibt es keine gute Möglichkeit, Markdown direkt in eine PDF-Datei mit Syntaxhervorhebung zu konvertieren.

Alternativen:

Vim :

Wenn Sie vim haben, können Sie die Syntaxhervorhebung auf einfache Weise erreichen, indem Sie Folgendes von einem Terminal aus ausführen:

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

Oder innerhalb von vim:

:hardcopy >/path/to/file.ps

Dadurch wird eine PostScript-Datei erstellt, die beispielsweise mit ps2pdf in PDF konvertiert werden kann:

ps2pdf /path/to/file.ps

Quell-Highlight :

Wenn Sie stattdessen HTML oder LaTeX verwenden möchten, können Sie stattdessen Source-highlight verwenden. Eine Liste aller von Source-highlight unterstützten Sprachen finden Sie hier .

Einige Beispiele für Source-Highlight-Befehle sind:

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

Verwendung dieser Eingabedatei

Und jeder gibt seine eigene HTML-Datei aus:

Hallo1.html
Hallo2.html
Hallo3.html

Weitere Beispiele für die Verwendung von Source-Highlights finden Sie hier

Windows :

Vim , ps2pdf (bereitgestellt von Ghostscript ) und Source-Highlight sind alle über Cygwin verfügbar .

Verwenden Sie für Linux- Benutzer pandoc .

Installieren:

sudo apt install pandoc texlive-latex-extra

Ja, Sie benötigen ein -extraPaket wegen der Schriftarten.

Konvertieren:

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

Ich habe kürzlich einen Dienst zum Konvertieren von Markdown-Dokumenten in PDF erstellt. Es unterstützt Github-Markdown sowie Syntaxhervorhebung. Der Service befindet sich unter: http://markdown2pdf.com

Meine Lösung: Konvertieren Sie Markdown mit pandocin HTML (vergessen Sie nicht, CSS für Pandoc zu verwenden, um Tabellenränder anzuzeigen ) , öffnen Sie es dann mit libreofficeund wählen Sie eine Option aus export as pdf.

NB : Keine der hier und im Internet erwähnten Lösungen hat für mich funktioniert: 1) Browser-basierte Lösungen (dh Grip) fügen überschüssige Informationen hinzu, wie Seitenzahlen, die ich nicht entfernen konnte, 2) Pandoc-Konvertierung in PDF ist für mich gebrochen, erzeugt er eine leere Tabelle (vielleicht wegen der Unicode, und ja, ich konfigurierte es xetex verwenden) , 3) Website - basierten Lösungen (dh gitprint.com) sind auch das Hinzufügen redundante Dinge, wie github artige Margen, während Ich brauche nur eine einfache Tabelle, die ich mit awk erstellt habe!

Ich habe verschiedene Chrome-Plugins und Online-Konverter ausprobiert.
MDtr2PDF ist das beste. Es unterstützt Github-Markdown und Unicode.

Ich habe dieses Snippet für meine persönlichen Bedürfnisse verfeinert :

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

Speichern Sie als /usr/local/bin/md2pdfund sudo chmod +x /usr/local/bin/md2pdfdanach.

Verwendungszweck:

• md2pdf konvertiert README.md in README.md.pdf

• md2pdf foo.md konvertiert foo.md in foo.md.pdf

• md2pdf foo.md bar.pdf wandelt foo.md in bar.pdf um