Markdown (.md) in ein sauberes PDF umwandeln

So nutzen Sie „Markdown in PDF“

1. Ihre .md-Datei öffnenWählen Sie eine Markdown-Datei aus oder ziehen Sie sie auf das Werkzeug. Exporte aus Notiz-Apps, Wikis und Code-Repositorys funktionieren, solange sie die übliche Markdown-Syntax verwenden.
2. Papier und Grundschriftgröße einstellenWählen Sie A4 oder US-Letter und dann die Grundschriftgröße für den Fließtext. Mit einer kleineren Größe passt mehr von einer breiten Tabelle oder einer langen Codezeile auf die Seite.
3. PDF erstellen und herunterladenErstellen Sie das PDF und speichern Sie es. Öffnen Sie es einmal und prüfen Sie Überschriften, Tabellen und eventuelle Bildplatzhalter, bevor Sie es weitergeben.

Ein Beispiel mit Zahlen

Die README.md eines Projekts enthält einen Titel, zwei Abschnitte, eine nummerierte Installationsliste, einen Shell-Codeblock und eine Tabelle mit drei Spalten. Mit A4 und der voreingestellten Grundgröße von 11 pt wird der Titel (#) in 22 pt gesetzt (11 × 2), die Abschnittsüberschriften (##) in 17,6 pt (11 × 1,6), der Codeblock in Courier mit 9,68 pt (11 × 0,88) auf einem grau hinterlegten Band und der Tabellentext in 10,12 pt (11 × 0,92).

Die Textbreite von 171,9 mm (210 mm minus zwei Ränder von je 19,05 mm) wird gleichmäßig aufgeteilt, jede der 3 Tabellenspalten erhält also rund 57,3 mm. Das Ergebnis wird als README.pdf heruntergeladen.

Was es kann und wo die Grenzen liegen

• Bilder erscheinen als Platzhalter [image: Alternativtext], weil verlinkte Dateien nicht geladen werden.
• Nur http-, https- und mailto-Links sind klickbar; relative Links erscheinen als formatierter Text.
• Fußnoten, mathematische Formeln und Diagrammcode werden nicht als solche dargestellt.
• Der Stil ist fest vorgegeben: keine Themes, kein eigenes CSS.
• Schriften, die von rechts nach links laufen, und komplexe Schriften wie Arabisch, Hindi und Thai werden nicht korrekt gesetzt.

Mehr über „Markdown in PDF“

Markdown schreibt sich angenehm, doch wer nicht programmiert, bekommt lieber ein Dokument als eine Datei voller Rautezeichen und Sternchen. Dieses Werkzeug liest Ihr Markdown mit marked, einer quelloffenen Bibliothek unter MIT-Lizenz, und hält sich dabei an die CommonMark-Spezifikation plus zwei GitHub-Erweiterungen: Tabellen und Durchstreichen. Das eingelesene Dokument wird anschließend in einem einheitlichen, gut lesbaren Stil auf A4- oder US-Letter-Seiten gesetzt.

Elemente, die formatiert herauskommen

• Überschriften, Absätze, fett, kursiv und durchgestrichen
• Inline-Code sowie abgegrenzte Codeblöcke in einer Festbreitenschrift auf grauem Hintergrund
• Aufzählungen, nummerierte und verschachtelte Listen
• Zitatblöcke und horizontale Linien
• Tabellen, gezeichnet als einfaches Raster
• Links, die im PDF klickbar bleiben

Das Aussehen ist festgelegt: Es gibt keine Themes und keine Möglichkeit, eigenes CSS anzuwenden. Sie bestimmen zwei Dinge, das Papierformat und die Grundschriftgröße. So bleibt das Werkzeug schnell bedienbar und das Ergebnis einheitlich, was zu Handouts, Dokumentation und Berichten besser passt als zu durchgestalteten Broschüren.

Typische Anwendungsfälle

• Eine README für jemanden außerhalb des Repositorys

  In Markdown geschriebene Einrichtungshinweise eines Projekts können als PDF an Kunden oder Vorgesetzte gehen, das sich überall öffnen lässt: die Installationsschritte als nummerierte Listen, die Befehle in grau hinterlegten Codeblöcken.

• Besprechungsnotizen als Handout

  Schnell in Markdown getippte Notizen mit einer Überschrift je Thema, Aufzählungspunkten für Beschlüsse und einer kleinen Tabelle mit Zuständigen und Terminen werden zu einer druckfertigen Seite für die nächste Besprechung.

• Eine Hausarbeit aus dem Texteditor

  Das Kursportal nimmt nur PDF an, Sie schreiben aber in Markdown. Wandeln Sie die fertige Datei um und laden Sie ein Dokument hoch, dessen Überschriften, Zitate und Quellenlinks ihre Formatierung behalten.

Warum Bilder als Platzhalter erscheinen

Markdown verweist auf Bilder über einen Pfad oder eine Webadresse, etwa ![Lageplan](bilder/plan.png). Diese Seite lädt keine Dateien von außerhalb der Website, verlinkte Bilder werden also nicht abgerufen. An ihrer Stelle zeigt das PDF einen Platzhalter [image: Alternativtext] mit der Beschreibung aus den eckigen Klammern, damit Leser erkennen, dass dort ein Bild hingehörte. Aussagekräftiger Alternativtext in Ihrem Markdown zahlt sich deshalb aus.

Kommt es auf die Bilder an, machen Sie daraus ein PDF mit JPG in PDF oder PNG in PDF und fügen Sie es mit PDF zusammenfügen mit dem gesetzten Text zusammen.

Sprachen und die Schriften dahinter

Deutsch, Englisch und andere Sprachen in lateinischer Schrift verwenden Helvetica und Courier, Standardschriften, die jeder PDF-Viewer schon mitbringt; eingebettet werden muss also nichts. Griechisch und Kyrillisch werden in Roboto gesetzt, Chinesisch und Japanisch in Droid Sans Fallback (beide Apache-2.0) und Koreanisch in Nanum Gothic (SIL Open Font License). Jede dieser Schriften wird als Teilmenge eingebettet, die nur die Zeichen Ihres Dokuments enthält. Die Schrift für Chinesisch und Japanisch ist ein Download von rund 4 MB, die koreanische einer von rund 2 MB, und Ihr Browser ruft jede nur dann ab, wenn das Markdown tatsächlich solche Zeichen enthält.

Koreanischer Text bricht zwischen Wörtern um, wie es im koreanischen Satz üblich ist. Arabisch, Hebräisch und andere Schriften, die von rechts nach links laufen, sowie komplexe Schriften wie Hindi und Thai werden nicht korrekt gesetzt. Für Dokumente in diesen Sprachen führt eine Textverarbeitung oder ein Browser, der sie unterstützt, zuverlässiger zum PDF.

Qualität und Größe des Ergebnisses

Der gesamte Text im PDF ist Vektortext: scharf in jeder Zoomstufe, durchsuchbar und kopierbar. Da keine Bilder eingebettet und die Schriften auf Teilmengen reduziert werden, ergibt ein typisches Markdown-Dokument eine leichte Datei, die sich bequem per E-Mail verschicken lässt. Links funktionieren in Viewern, die sie unterstützen. Für einen Ausdruck mit Seitenzahlen schicken Sie das Ergebnis anschließend durch Seitenzahlen einfügen.

Syntax, die nicht dargestellt wird

• Bilder, die wie oben beschrieben zu Platzhaltern werden.
• Eigene Gestaltung: eigenes CSS, Themes, Farben und Schriftwahl.
• Erweiterungen außerhalb von CommonMark, abgesehen von GitHub-Tabellen und Durchstreichen. Fußnoten, mathematische Formeln und als Code geschriebene Diagramme gehören nicht dazu; rechnen Sie also mit ihrem Quelltext statt mit einer fertigen Darstellung.
• Reine Textdateien. Ist Ihre Datei eigentlich kein Markdown, behält TXT in PDF jede Zeile und jedes Leerzeichen genau so, wie sie getippt wurden.

Einlesen und Seitenlayout laufen beide in diesem Browser-Tab; das Markdown und das fertige PDF bleiben auf Ihrem Gerät. So können Sie das überprüfen.