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.
147
Antworten:
Ich hatte Erfolg mit Grip , um Markdowns in Chrome anzuzeigen und dann die Option "Als PDF speichern" in Chrome im Dialogfeld "Drucken" zu verwenden.
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).
quelle
grip your_markdown.md --export your_markdown.html
ist hier eine nützliche Option. Exportiert es in die HTML-Datei, die dann über die Befehlszeile mit so etwas wie wkhtmltopdf gedruckt werden kann.Sie können auch Node.js basiertes markdown-pdf verwenden
quelle
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.
quelle
pandoc -h
hat die Unterstützung für GitHub Flavored Markdown zurückgegeben, daher markiere ich diese Frage als gelöst.pandoc
auf Fedora Linux zu installieren, und bin auf einen Abhängigkeits-Albtraum gestoßen, der hauptsächlich mit LaTex zusammenhängt. Mein Rat wäre, Pandoc zu überspringen und zuerst andere Optionen auszuprobierenpandoc
--variable mainfont="Liberation Serif" --variable sansfont="Liberation Sans"
sudo apt install pandoc texlive-latex-recommended texlive-xetex texlive-luatex pandoc-citeproc etoolbox wkhtmltopdf
(auf Ubuntu wahrscheinlich nicht alle notwendig), dannpandoc --variable urlcolor=cyan myfile.md -o myfile.pdf
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.com
durch zu ersetzengitprint.com
. Hier ist ein Beispiel von der Homepage von gitprint.Leider funktioniert es nicht mit Markdown-Listen und nur mit Markdown-Dateien im Repository.
quelle
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.
quelle
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:
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:
Oder innerhalb von vim:
Dadurch wird eine PostScript-Datei erstellt, die beispielsweise mit ps2pdf in PDF konvertiert werden kann:
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:
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 .
quelle
Verwenden Sie für Linux- Benutzer pandoc .
Installieren:
Ja, Sie benötigen ein
-extra
Paket wegen der Schriftarten.Konvertieren:
quelle
<font color="red">
obwohlIch 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
quelle
Meine Lösung: Konvertieren Sie Markdown mit
pandoc
in HTML (vergessen Sie nicht, CSS für Pandoc zu verwenden, um Tabellenränder anzuzeigen ) , öffnen Sie es dann mitlibreoffice
und wählen Sie eine Option ausexport 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!
quelle
pandoc
sollte für Sie arbeiten mit Optionen wie--variable mainfont="Liberation Serif" --variable sansfont="Liberation Sans"
Ich habe verschiedene Chrome-Plugins und Online-Konverter ausprobiert.
MDtr2PDF ist das beste. Es unterstützt Github-Markdown und Unicode.
quelle
Ich habe dieses Snippet für meine persönlichen Bedürfnisse verfeinert :
Speichern Sie als
/usr/local/bin/md2pdf
undsudo chmod +x /usr/local/bin/md2pdf
danach.Verwendungszweck:
md2pdf
konvertiert README.md in README.md.pdfmd2pdf foo.md
konvertiert foo.md in foo.md.pdfmd2pdf foo.md bar.pdf
wandelt foo.md in bar.pdf umquelle