Markdown in PDF

Über das Umwandeln von Markdown in ein PDF

Markdown ist die einfachste Art, ein Dokument zu schreiben, und die umständlichste, eines zu verschicken.

Sie haben die Notizen geschrieben, die README, die Spezifikation, den Bericht. Im Editor sieht alles perfekt aus. Dann fragt jemand danach als PDF, und die Möglichkeiten sind: eine Toolchain installieren, alles in eine Textverarbeitung kopieren und die Formatierung von Hand reparieren, oder es in ein Repository schieben und die Seite abfotografieren.

Fügen Sie es stattdessen hier ein. Die Vorschau rechts ist das, was im PDF steht, und der Knopf macht eines daraus.

Was den Weg übersteht

Alles, was man von GitHub-Markdown erwartet:

• Überschriften — alle Ebenen, mit den Abständen, die ein Dokument haben soll
• Listen — mit Punkten, mit Nummern und verschachtelt
• Tabellen — mit Rahmen und hinterlegter Kopfzeile
• Code — so im Fließtext und als Block mit erhaltenen Abständen
• Zitate, Trennlinien, fett, *kursiv* und Links
• Bilder, sofern sie data-URIs oder erreichbare URLs sind

Vorschau und PDF entstehen aus demselben Stylesheet, was Sie sehen, ist also wirklich das Gedruckte. Es gibt keinen zweiten Layout-Schritt, der Sie überrascht.

Zwei Stile

• Schlichtes Dokument — eine Serifenschrift und großzügiger Zeilenabstand. Richtig für einen Bericht, ein Angebot, einen Text, alles, was jemand von vorne bis hinten liest.
• README-Stil — eine serifenlose Schrift mit unterstrichenen Überschriften, näher daran, wie eine README auf einer Code-Plattform aussieht. Richtig für Dokumentation und technische Notizen.

Seiteneinrichtung

A4 oder Letter, Hoch- oder Querformat und ein Rand, den Sie in Millimetern angeben. An Querformat lohnt es sich bei breiten Tabellen und langen Codezeilen zu denken — es entscheidet darüber, ob eine Tabelle passt oder umbricht.

Seitenzahlen sind standardmäßig an und stehen mittig am Fuß jeder Seite. Bei einem einseitigen Dokument schalten Sie sie aus, da stiften sie nur Unruhe.

Nichts verlässt Ihr Gerät

Das Markdown wird in Ihrem Browser gerendert und das PDF dort geschrieben. Nichts wird hochgeladen, also:

• Unveröffentlichte Spezifikationen, interne Notizen und Kundenarbeit bleiben, wo sie sind
• Es gibt keine Größenbeschränkung durch einen Upload
• Es funktioniert offline, sobald die Seite geladen ist
• Ihr Text bleibt zwischen Besuchen in diesem Browser erhalten, damit ein geschlossener Tab die Arbeit nicht verliert — und nur in diesem Browser

Warum die Seiten gezeichnet und nicht gesetzt werden

Jede Seite wird als Bild gezeichnet und ins PDF gelegt, statt als PDF-Text geschrieben zu werden. Das ist Absicht: die Standard-PDF-Schriften können Hangul, Kana, Han oder Kyrillisch gar nicht kodieren, und ein Markdown-Dokument kann in jeder Sprache sein.

Das Zeichnen nutzt Ihre eigenen Systemschriften, also wird jede Schrift korrekt dargestellt. Der Preis ist, dass sich der Text im fertigen PDF nicht markieren lässt — derselbe Handel, den Word in PDF aus demselben Grund macht. Wenn Sie markierbaren Text brauchen und Ihr Dokument rein lateinisch ist, zeigt Lebenslauf-Generator, wie der andere Weg aussieht.

Was Leute umwandeln

• Eine README oder Dokumentationsseite für jemanden, der keine Code-Plattform nutzt
• Besprechungsnotizen in Markdown, die als Dokument weitergehen
• Eine Spezifikation oder ein Angebot, im Texteditor entworfen
• Lernnotizen zum Ausdrucken oder Lesen auf dem Tablet
• Ein Änderungsprotokoll oder eine Release-Notiz als E-Mail-Anhang
• Kursmaterial, in Markdown geschrieben und als PDF ausgegeben

Gut zu wissen

• Rohes HTML in Ihrem Markdown wird vor dem Rendern gesäubert, ein eingefügtes Dokument kann also nichts ausführen
• Ein sehr langes Dokument braucht ein paar Sekunden pro Seite — die Arbeit ist vollständig lokal
• Bilder aus dem Internet erscheinen nur, wenn die Seite erlaubt, dass eine andere Seite sie liest; als data-URI eingefügte Bilder funktionieren immer
• Für die andere Richtung, oder um einfach Markdown zu schreiben, gibt es den Markdown-Editor
• Um das Ergebnis mit einem anderen PDF zu verbinden, nehmen Sie PDF zusammenfügen

So wird es benutzt

• Fügen Sie Ihr Markdown links ein oder drücken Sie .md öffnen, um eine Datei zu laden
• Prüfen Sie die Vorschau rechts — so wird das PDF aussehen
• Wählen Sie Seitengröße, Ausrichtung, Rand und Stil
• Haken Sie Seitenzahlen hinzufügen an, wenn Sie welche möchten
• Drücken Sie PDF erstellen und dann PDF herunterladen

Verwandte Werkzeuge

• Markdown-Editor — Markdown mit Werkzeugleiste und Live-Vorschau schreiben
• Word in PDF — dieselbe PDF-Engine, ausgehend von einer .docx
• PDF in Text — reinen Text wieder aus einem PDF holen
• PDF zusammenfügen — dieses PDF mit anderen verbinden
• Seitenzahlen einfügen — ein vorhandenes PDF nummerieren
• PDF komprimieren — die Datei vor dem Versenden verkleinern