Markdown in PDF umwandeln

Warum Markdown in eine PDF umwandeln

In Markdown schreiben Entwickler, Autorinnen und Notiz-Apps wie Obsidian, Joplin und Typora ihre Texte: als reiner Text lesbar und formatiert, sobald eine App ihn anzeigt. Außerhalb dieser Apps ist eine .md-Datei nur eine Wand aus Rautezeichen und Sternchen – nichts, was Sie einem Kunden mailen, abgeben oder drucken möchten. Dieses Werkzeug liest das Markdown in Ihrem Browser mit marked, einem Open-Source-Parser, der den Regeln von GitHub Flavored Markdown folgt, und setzt es als sauberes Dokument: Überschriften, fetter und kursiver Text, nummerierte und Aufzählungslisten, Aufgabenlisten mit Kästchen, Tabellen mit Rahmen, Zitate und Codeblöcke in einer Schrift mit fester Zeichenbreite, die umbrechen, statt über den Seitenrand hinauszulaufen. Die PDF schreibt dann die Druckfunktion des Browsers selbst, sodass der Text scharf und durchsuchbar bleibt. YAML-Front-Matter am Anfang der Datei, wie sie Blogs und statische Website-Generatoren verwenden, wird nicht in die PDF übernommen.

So wandeln Sie Markdown in PDF um

1. Ziehen Sie Ihre .md-Datei in das Feld oder klicken Sie, um sie auszuwählen. Eine Vorschau des formatierten Dokuments erscheint.
2. Wählen Sie Seitengröße, Ränder und Schriftgröße.
3. Klicken Sie auf „PDF erstellen“. Wählen Sie im Druckdialog Ihres Browsers „Als PDF speichern“ als Drucker bzw. Ziel und speichern Sie die Datei.

Was Sie über Markdown und PDF wissen sollten

Bilder, die nur verlinkt sind

Markdown verweist auf Bilder meist über eine Adresse, etwa  oder einen Weblink. Das Werkzeug hat nur die .md-Datei, nicht den Ordner drumherum, und lädt nichts aus dem Internet, daher erscheinen solche Bilder als kleiner Kasten mit ihrer Beschreibung. Bilder, die als Data-URL in die Datei eingebettet sind, werden gedruckt. Um Bilder auf anderem Weg in die PDF zu bekommen, öffnen Sie das Markdown in einem Editor, der die Bilder anzeigt, und drucken Sie von dort.

HTML im Markdown

Einfaches HTML wie <br>, <sup>, <details> oder eine in HTML geschriebene Tabelle bleibt erhalten. Skripte, Frames, Formulare, Stile und eingebettete Videos werden entfernt, weil sie nicht in ein gedrucktes Dokument gehören und unsicher sein könnten.

Keine Syntaxhervorhebung

Codeblöcke werden in einer Schrift mit fester Zeichenbreite und mit einem hellen Rahmen gedruckt, aber ohne die Farben, mit denen ein Editor Schlüsselwörter und Zeichenketten hervorhebt. Lange Codezeilen werden umbrochen, damit am Seitenrand nichts abgeschnitten wird.

Markdown-Varianten

Tabellen, Aufgabenlisten, Durchstreichungen und automatische Links folgen den Regeln von GitHub, die die meisten Apps teilen. Erweiterungen, die nur manche Apps kennen, etwa Fußnoten, mathematische Formeln, Mermaid-Diagramme, Wiki-Links zwischen Notizen oder Obsidian-Callouts, erscheinen als ihr reiner Text.