Markdown schön drucken

Der schnellste Weg, mdprint auszuprobieren, ist, einfach im Editor auf der Startseite zu tippen. Er lädt mit einem Beispieldokument, das jede Funktion ausreizt - Tabellen, Code, Mathe, Diagramme - sodass du sofort siehst, wie eine fertige Seite aussieht. Lösche das Beispiel und tippe deinen eigenen Inhalt, oder füge ihn von dort ein, wo du ihn geschrieben hast.

Wenn du bereits eine Markdown-Datei auf deinem Computer hast, hast du zwei Möglichkeiten, sie zu laden. Die erste ist, sie aus deinem Dateimanager zu ziehen und auf den Editor-Bereich abzulegen. Während des Ziehens erscheint eine Hervorhebung um die Drop-Zone. Lass die Datei los, und der Editor füllt sich mit ihrem Inhalt. Die zweite ist, auf die Schaltfläche Importieren in der Symbolleiste zu klicken und die Datei im Dateiauswahldialog auszuwählen. Beide Methoden lesen die Datei lokal - nichts wird hochgeladen.

mdprint akzeptiert .md-, .markdown- und .txt-Dateien. Die Endung .txt ist nützlich für Dokumente, die als Markdown geschrieben, aber von einem anderen Tool mit einer generischen Endung gespeichert wurden. Wenn du versuchst, eine Datei mit einer anderen Endung zu importieren, zeigt mdprint einen Fehler an und lässt deinen aktuellen Inhalt unberührt.

Falls du noch nie Markdown geschrieben hast: Die Regeln lassen sich in fünf Minuten lernen. Du schreibst reinen Text, und vier Zeichen erledigen den Großteil der Arbeit. Das Symbol # am Zeilenanfang erzeugt eine Überschrift - ein # für die größte, sechs ###### für die kleinste. Die Symbole * und _ um ein Wort machen es kursiv mit je einem auf jeder Seite und fett mit zwei. Das Symbol - oder * am Zeilenanfang erzeugt einen Aufzählungspunkt. Rücke zwei Leerzeichen ein, um einen Punkt unter einen anderen zu verschachteln.

Code wird mit Backticks behandelt. Ein Backtick auf jeder Seite einer Phrase formatiert sie als `Inline-Code`. Drei Backticks auf einer eigenen Zeile starten einen Codeblock, und drei weitere beenden ihn. Wenn du einen Sprachnamen direkt nach den drei öffnenden Backticks setzt (```python, ```typescript, ```sql), bekommt der Codeblock Syntaxhervorhebung in dieser Sprache. Ohne Sprachhinweis versucht der Highlighter, anhand des Inhalts zu raten, was bei populären Sprachen meist klappt.

Links und Bilder verwenden beide eckige Klammern und runde Klammern. Ein Link ist [der angezeigte Text](die URL). Ein Bild ist dasselbe mit vorangestelltem Ausrufezeichen: . Beim Drucken in PDF werden Bild-URLs, die auf öffentlich zugängliche Server zeigen, abgerufen und eingebettet. Bilder auf deinem lokalen Rechner oder hinter Authentifizierung werden nicht gerendert - lege sie direkt als base64 data-URLs im Editor ab, wenn du sie inline brauchst.

Tabellen sind das eine Stück Markdown, das im Quelltext umständlich aussieht, aber sauber rendert. Eine Kopfzeile, eine Trennzeile aus Strichen und eine oder mehrere Datenzeilen, alle getrennt durch Pipes. Die Spalten müssen im Quelltext nicht ausgerichtet sein - der Renderer kümmert sich um den Abstand. Füge einen Doppelpunkt an einem oder beiden Enden der Striche in der Trennzeile hinzu, um die Ausrichtung zu steuern: :--- für links, ---: für rechts, :---: für zentriert.

Mathe-Gleichungen verwenden TeX-Syntax in Dollarzeichen. Ein einzelnes Dollarzeichen auf jeder Seite ergibt Inline-Mathe: $a^2 + b^2 = c^2$. Zwei Dollarzeichen auf eigenen Zeilen ergeben eine Display-Gleichung, zentriert auf eigener Zeile und größer. Alle erwarteten LaTeX-Mathe-Befehle - \frac, \int, \sum, \sqrt, griechische Buchstaben, Matrizen, der AMS-Symbolsatz - funktionieren, weil mdprint KaTeX nutzt, das dieselbe Syntax implementiert.

Diagramme verwenden Mermaid-Syntax in einem eingezäunten Codeblock mit dem Sprach-Tag mermaid. Das einfachste Diagramm ist ein Flussdiagramm: Öffne mit graph LR (links-nach-rechts) oder graph TD (oben-nach-unten), dann schreibe Knoten, die durch Pfeile verbunden sind. Mermaid unterstützt außerdem Sequenzdiagramme (Nachrichtenfluss zwischen Akteuren über Zeit), Gantt-Diagramme (Projektzeitpläne mit Abhängigkeiten), Klassendiagramme (Objektbeziehungen) und Zustandsdiagramme (Zustandsmaschinen). Die Mermaid-Dokumentation hat Beispiele für jeden Typ.

Fußnoten ermöglichen es dir, den Fließtext lesbar zu halten und dennoch ausführliche Quellenangaben oder Nebenbemerkungen anzuhängen. Markiere eine Fußnote im Text mit [^1] (die Nummer kann beliebig sein - sie werden in der Ausgabe neu nummeriert). Definiere die Fußnote irgendwo anders im Dokument mit [^1]: der Fußnoteninhalt. mdprint sammelt alle Fußnoten am Ende des gedruckten Dokuments und fügt Rückverweise hinzu, die jede Fußnote mit der Stelle verknüpfen, an der sie im Text erscheint.

Wenn dein Dokument lang ist, lass den wörtlichen Text [[toc]] an der Stelle in der Quelle, an der ein Inhaltsverzeichnis erscheinen soll. mdprint ersetzt ihn durch eine verschachtelte Liste von Links zu jedem H2 und H3 im Dokument. Im gedruckten PDF wird dasselbe Inhaltsverzeichnis zu einer Navigations-Gliederung, die PDF-Reader nutzen können.

Öffne das Einstellungsfeld aus der Symbolleiste, um zu steuern, wie deine PDF erzeugt wird. Seitenformat hat zwei Optionen: A4 (Standard außerhalb Nordamerikas) oder Letter (Standard in Nordamerika). Die Ausrichtung schaltet zwischen Hoch- und Querformat - Querformat ist nützlich für Dokumente mit breiten Tabellen oder Diagrammen. Ränder bietet drei Voreinstellungen: schmal gibt mehr Nutzfläche für dichten Inhalt, normal ist der konventionelle Mittelweg, und breit lässt Raum für handschriftliche Anmerkungen auf einem Ausdruck.

Der Editor hat eigene helle und dunkle Themen, unabhängig vom Rest der Seite. Der Schalter in der Symbolleiste wechselt zwischen ihnen. Die Vorschau und die Druckausgabe bleiben unabhängig davon im hellen Modus, weil helle Hintergründe gut auf Papier drucken.

Wenn du regelmäßig denselben Satz von Optionen verwendest, wird deine letzte Auswahl lokal gemerkt und beim nächsten Öffnen von mdprint im selben Browser automatisch angewendet.

Die Schaltfläche Drucken öffnet den nativen Druckdialog deines Browsers. Von dort bietet jedes moderne Betriebssystem Als PDF speichern als Ziel - Chrome, Firefox, Safari und Edge unterstützen es alle auf macOS, Windows und Linux. Den Druckdialog zu nutzen, gibt dir die meiste Kontrolle: Du kannst jeden Drucker wählen, jede Seite vorab ansehen, die Ausrichtung pro Seite ändern, falls dein Treiber das unterstützt, und bei manchen Druckern Papierfächer oder Heftung ändern.

Die Schaltfläche PDF herunterladen überspringt den Druckdialog und erzeugt eine PDF-Datei direkt im Browser, dann wird ein Download ausgelöst. Sie nutzt deine aktuellen Einstellungen (Seitenformat, Ausrichtung, Ränder) zur Formatierung. Diese Route ist schneller, wenn du genau weißt, was du willst, und die Flexibilität des Druckdialogs nicht brauchst. Sie funktioniert, indem die Seite als hochauflösendes Bild gerendert und dieses Bild in das PDF gelegt wird, sodass das Ergebnis immer dem entspricht, was du auf dem Bildschirm siehst. Der Kompromiss: Weil die Seite zu einem Bild wird, ist der Text in diesem PDF nicht auswählbar oder durchsuchbar.

Die beiden Routen unterscheiden sich darin, was am Ende in der Datei landet. Als PDF speichern über die Schaltfläche Drucken behält Text als Text: Er bleibt auswählbar und durchsuchbar, bleibt bei jedem Zoom gestochen scharf, und Diagramme bleiben Vektoren. PDF herunterladen ist stattdessen ein Bild-Schnappschuss per Klick, also schnell und pixelgenau, aber der Text ist nicht auswählbar. Nimm Als PDF speichern, wenn du auswählbaren Text oder das schärfste Ergebnis bei jedem Zoom willst; nimm PDF herunterladen, wenn du einfach eine schnelle, exakte Kopie dessen willst, was auf dem Bildschirm steht, ohne den Druckdialog zu öffnen.

Seitenumbrüche an unschönen Stellen. mdprint vermeidet Umbrüche innerhalb von Codeblöcken, Tabellen und Diagrammen, rät aber bei Fließtext nicht. Wenn eine Überschrift unten auf einer Seite landet und der Abschnittsinhalt auf der nächsten, ist die einfachste Lösung, ein paar Sätze davor oder danach einzufügen, um die Überschrift zu verschieben. Es gibt in V1 keine manuelle Seitenumbruch-Syntax - sie hinzuzufügen steht auf der V2-Liste.

Bilder erscheinen nicht im PDF. Die häufigste Ursache ist eine Bild-URL, die auf dein lokales Dateisystem (file://) oder auf einen Server zeigt, der keinen Cross-Origin-Zugriff erlaubt. Entweder betten das Bild als data-URL direkt in die Markdown-Quelle ein, oder lade es auf einen Bildhoster hoch, der öffentlichen Lesezugriff erlaubt. Imgur, GitHubs user-content-Server und die meisten CDNs funktionieren.

Mathe wird nicht gerendert. Prüfe die Quelle auf nicht-escapte Dollarzeichen in normalem Text - ein verlorenes $ kann eine Mathe-Spanne starten, die den Rest des Absatzes verschluckt. Wenn du ein wörtliches Dollarzeichen im Fließtext brauchst, escape es: \$. Wenn die Mathe-Syntax korrekt ist, die Gleichung aber dennoch nicht rendert, ist der LaTeX-Befehl vielleicht nicht in KaTeX's Liste - die KaTeX-Dokumentation hat eine vollständige Referenz.

Das Diagramm ist leer. Mermaid ist streng mit der Syntax. Die häufigsten Fehler sind ein fehlendes Leerzeichen nach graph LR, eine Knoten-ID mit einem Leerzeichen darin (nutze camelCase oder Unterstriche), oder ein Pfeil, der auf einen undefinierten Knoten zeigt. Öffne die Entwicklerkonsole deines Browsers - Mermaid loggt eine spezifische Fehlermeldung, wenn das Parsen fehlschlägt.

Tabellen umbrechen seltsam. Wenn eine Tabelle breiter als die Seite ist, skaliert mdprint sie herunter, damit sie passt. Für sehr breite Tabellen wechsle in den Einstellungen zur Querformat-Ausrichtung oder strukturiere die Tabelle als Liste um. PDF handhabt horizontales Scrollen nicht so wie das Web.

Nutze die Tastenkürzel. Cmd+P (oder Ctrl+P auf Windows und Linux) öffnet den Druckdialog. Cmd+S (Ctrl+S) löst PDF herunterladen aus. Die eigenen Tastenkürzel des Browsers für Suchen (Cmd+F), Neuladen (Cmd+R) und Zoom (Cmd+plus/minus) funktionieren alle normal - sie kollidieren nicht mit mdprint.

Beginne jedes Dokument mit einer H1. Die erste H1 wird zum vorgeschlagenen PDF-Dateinamen, zum Dokumenttitel für Barrierefreiheit und zur prominenten Überschrift oben auf der gedruckten Seite. Falls du mit H2 oder niedriger beginnst, fällt der Dateiname auf 'document.pdf' zurück, und du musst ihn nach dem Download manuell umbenennen.

Bette Bilder als data-URLs ein, wenn Datenschutz wichtig ist. Wenn du nicht willst, dass ein PDF-Reader Bilder von einem entfernten Server abruft, wenn er deine Datei öffnet, wandle das Bild in eine base64-data-URL um und bette es direkt ein. Die meisten Betriebssysteme haben ein eingebautes oder spezielles Tool für diese Umwandlung. Die resultierende Datei ist größer, aber vollständig eigenständig.

Nutze Aufgabenlisten für gedruckte Checklisten. Wenn du eine Papier-Checkliste produzierst - eine Packliste, eine Versand-Checkliste, eine Schritt-für-Schritt-Anleitung - verwende Markdown-Aufgabenlisten-Syntax mit - [ ]. Die Kästchen werden als Quadrate gedruckt, die du mit einem Stift abhaken kannst.

Kombiniere mermaid und Code in technischer Dokumentation. Ein häufiges Muster ist, ein Flussdiagramm eines Prozesses zu zeigen, gefolgt vom tatsächlichen Code, der ihn umsetzt. Markdown erlaubt beides in derselben Datei, und mdprint rendert sie so, dass sie sauber nebeneinander gedruckt werden.

Cmd+P oder Ctrl+P - Druckdialog öffnen.

Cmd+S oder Ctrl+S - als PDF herunterladen.

Cmd+B oder Ctrl+B im Editor - markierten Text fett.

Cmd+I oder Ctrl+I im Editor - markierten Text kursiv.

Cmd+/ oder Ctrl+/ im Editor - Kommentar für die aktuelle Zeile umschalten (HTML-Kommentar im Markdown-Kontext).

Esc im Editor bei Vollbild - Vollbild verlassen.