Markdown in PDF umwandeln

Machen Sie aus einer README, Notizen oder einer Dokumentation ein sauber gesetztes PDF – Tabellen im GitHub-Stil, hervorgehobener Code, Fußnoten und eine anklickbare Gliederung – und sehen Sie schon beim Bearbeiten genau, wie es aussieht.

Direkt nach dem Umwandeln gelöscht
Verschlüsselte Übertragung, sofort gelöscht
Ohne Anmeldung, ohne Wasserzeichen

Keine Datei zur Hand?

So funktioniert’s

Markdown hinzufügen

Legen Sie eine .md-Datei ab – zusammen mit ihren Bildern, falls sie welche verwendet – oder schreiben und fügen Sie direkt im Editor ein.

Seite gestalten

Wählen Sie Schriftart, Seitengröße und Ränder und fügen Sie ein Inhaltsverzeichnis hinzu. Die Vorschau aktualisiert sich während der Eingabe.

PDF erstellen

Überschriften werden zu PDF-Lesezeichen, und jeder Link bleibt anklickbar.

Welches Markdown – und was daraus wird

Markdown ist eher eine Familie als eine einzelne Spezifikation. Der gemeinsame Kern – Überschriften, Hervorhebungen, Listen, Links, Bilder, Blockzitate, Codeblöcke – ist überall gleich, darüber hinaus unterscheidet sich jede Implementierung. Unterstützt wird hier der weithin anerkannte erweiterte Umfang: Tabellen, eingezäunte Codeblöcke mit Syntaxhervorhebung, Aufgabenlisten, Durchstreichungen, Fußnoten und Front Matter. Das deckt ab, was fast alle schreiben – und es lohnt sich, die Grenze zu kennen, statt sie erst zu entdecken.

Überschriften werden zu echter PDF-Struktur statt nur zu größerem Text: Sie tragen Gliederungsebenen, sodass das PDF eine Lesezeichen-Seitenleiste zum Navigieren bekommt. Links werden zu funktionierenden Link-Annotationen. Codeblöcke werden in einer Festbreitenschrift mit Hervorhebung gesetzt – der Unterschied zwischen einem angenehm lesbaren Dokument und einer grauen Wand. Seitengröße und Ränder sind aufs Lesen ausgelegt statt übernommen, denn eine Markdown-Datei hat keine Meinung zum Papier.

Bilder müssen erreichbar sein, und das ist die häufigste Enttäuschung. Eine Markdown-Datei verweist auf Bilder, statt sie zu enthalten; ein relativer Pfad lässt sich daher nur auflösen, wenn das Bild zusammen mit der Datei abgelegt wird, und eine Webadresse nur, wenn der Server anderen Websites das Abrufen erlaubt. Ein Bild, das nicht gefunden wird, wird im PDF gekennzeichnet, statt eine stille Lücke zu hinterlassen – ein fehlendes Diagramm ist also sichtbar und fällt Ihnen nicht erst nach dem Versenden auf.

Zwei Dinge werden bewusst als Code angezeigt statt gerendert. Mathematische Formeln in LaTeX-Notation und Mermaid-Diagramme brauchen jeweils einen eigenen Renderer, und sie falsch darzustellen, ist schlimmer, als den Quelltext zu zeigen – eine falsch gerenderte Gleichung ist auf eine Weise falsch, die niemand sieht. Rohes HTML im Markdown wird für einfache Inline-Formatierung verarbeitet, nicht für Layout, denn ein beliebiger Markup-Block hat in einem paginierten Dokument keinen Platz.

Wenn Sie etwas anderes brauchen

Pandoc ist das ernsthafte Werkzeug dafür, und es ist kostenlos. pandoc doc.md -o doc.pdf --pdf-engine=xelatex setzt über LaTeX, was wirklich schöne Ergebnisse liefert – mit korrekter Silbentrennung, Hurenkinder-Kontrolle und einem echten Inhaltsverzeichnis –, und mit einer Vorlage bestimmen Sie jeden Aspekt der Gestaltung. Es rendert außerdem LaTeX-Formeln korrekt, genau die Lücke, die es hier gibt. Der Preis ist die Installation einer TeX-Distribution, und die ist nicht klein.

Für Dokumentation statt eines einmaligen Dokuments liefert ein Static-Site-Generator oder mdBook etwas Besseres als ein PDF: durchsuchbar, verlinkbar und auf dem Smartphone lesbar. Wandeln Sie in PDF um, wenn das Dokument gedruckt, angehängt oder archiviert werden muss – und behalten Sie das Markdown in jedem Fall als maßgebliche Quelle, denn das ist die Version, die sich bearbeiten und vergleichen lässt.

Häufig gestellte Fragen

Welche Markdown-Funktionen werden unterstützt?

Alles, was GitHub in einer README darstellt: Überschriften, Hervorhebungen, Durchstreichungen, Links und automatische Links, Bilder, Blockzitate, verschachtelte Listen, Aufgabenlisten, Tabellen mit Ausrichtung, eingezäunte Codeblöcke mit Syntaxhervorhebung für über 35 Sprachen, Fußnoten und Inline-HTML.

Wie binde ich Bilder ein?

Legen Sie die Bilder zusammen mit der .md-Datei ab (oder fügen Sie sie später hinzu). Sie werden über den Dateinamen zugeordnet, sodass ![chart](img/chart.png) die Datei chart.png findet, egal wo sie in Ihrem Ordner lag. Bilder aus dem Web werden eingebunden, wenn ihr Host das zulässt.

Bekomme ich ein Inhaltsverzeichnis?

Ja – setzen Sie das Häkchen bei „Inhaltsverzeichnis“ oder schreiben Sie [TOC] in eine eigene Zeile an der gewünschten Stelle. In beiden Fällen sind die Einträge Links, die zur richtigen Seite springen, und jede Überschrift erscheint außerdem in der Lesezeichen-Seitenleiste des PDFs.

Wird mein Text irgendwo gespeichert?

Ihr Markdown wird direkt hier in eine Webseite umgewandelt, und es wird nichts gespeichert. Diese Seite wird dann über eine verschlüsselte Verbindung an unseren Server gesendet, in ein PDF verwandelt und sofort gelöscht. Sollte dieser Server einmal nicht erreichbar sein, greift das Tool auf seinen eigenen Konverter zurück und sagt Ihnen das.

Erscheint Front Matter im PDF?

Nein. Ein YAML-Front-Matter-Block am Anfang wird aus der Seite herausgelassen, und sein title: wird zum Dokumenttitel des PDFs.

Ist HTML in meinem Markdown erlaubt?

Ja, für die Formatierung – <details>, <kbd>, <sup>, Tabellen und Ähnliches werden normal dargestellt. Skripte, Formulare und eingebettete Frames werden entfernt, denn ein Dokument hat keinen Grund, Code auszuführen.

Gut zu wissen: Mathematische Formeln und Mermaid-Diagramme werden als Code angezeigt statt gerendert. Bilder müssen zusammen mit der Datei abgelegt werden oder an einem Ort liegen, der das Abrufen erlaubt; ein fehlendes Bild wird im PDF gekennzeichnet, statt eine Lücke zu hinterlassen.