So funktioniert dieses Werkzeug
Markdown wird in Ihrem Browser vom mitgelieferten marked-Parser in HTML umgewandelt, dieses HTML öffnet sich in einem neuen Tab, und der Druckdialog Ihres Browsers schreibt die PDF, sobald Sie „Als PDF speichern“ als Ziel wählen. Es ist ein vollständiger CommonMark-Parser und keine Handvoll Regeln – auf dem Papier steht also, was ein Markdown-Editor am Bildschirm zeigt.
Überschriften bis zur sechsten Ebene, Aufzählungen und nummerierte Listen einschließlich verschachtelter, Pipe-Tabellen, umzäunter und eingebetteter Code, Zitatblöcke, Links, Bilder, Fett, Kursiv und Trennlinien werden alle aufbereitet. HTML ist innerhalb von Markdown zulässig und wird daher ebenfalls aufbereitet – zuvor jedoch von Skripten, eingebetteten Rahmen, Ereignis-Handlern und javascript:-Adressen befreit, denn diese Ausgabe wird in ein Fenster geschrieben, das anschließend ausgeführt wird.
Ein Dokument, das sich senden lässt
- Ein Link bleibt ein Link, aber kein aktiver: Die Linksyntax wird korrekt aufbereitet, und in den meisten PDF-Betrachtern bleibt die Adresse anklickbar. Auf Papier ist sie unsichtbar – schreiben Sie die Adresse also aus, wo die gedruckte Fassung für sich stehen muss.
- Tabellen wollen Querformat: Eine Pipe-Tabelle wird zu einer echten Tabelle, und eine breite wirkt auf A4 im Hochformat gedrängt. Wechseln Sie im Druckdialog die Ausrichtung, statt die Schrift zu verkleinern.
- Lange Codezeilen brechen um, statt abgeschnitten zu werden: Ein umzäunter Block, der breiter als die Seite ist, wird umbrochen, sodass am rechten Rand nichts verloren geht – dafür fallen die Zeilenumbrüche anderswo. Halten Sie Beispielzeilen kurz, wenn das zählt.
- Bilder brauchen eine erreichbare Adresse: Ein über einen relativen Pfad eingebundenes Bild hat nichts, wogegen es aufgelöst werden könnte, und erscheint nicht. Verwenden Sie eine vollständige https-Adresse und aktivieren Sie im Druckdialog die Hintergrundgrafiken.