Vom Markdown zum PDF, das sich zeigen lässt

1. Starte mit deinem Markdown

Füge deinen Text in den Editor ein oder öffne eine .md-, .markdown- oder .txt-Datei. Beginne mit einem aussagekräftigen Dokumententitel und gliedere den Rest anschließend in Abschnitte. Deine Änderungen aktualisieren die Vorschau während der Eingabe; es gibt keinen separaten Speicher- oder Aktualisierungsschritt für die Vorschau. Auf einem kleineren Bildschirm wechselst du über die Editor- und Vorschau-Tabs zwischen Schreiben und Prüfen.

Bewahre eine Kopie des ursprünglichen Markdowns auf. Wenn du eine Vorlage ausprobierst, prüfe deren Inhalt vor dem Export, damit kein Beispieltext im fertigen Dokument landet.

2. Setze Überschriften und Hervorhebungen gezielt ein

Schreibe einen Haupttitel mit einem einzelnen # gefolgt von einem Leerzeichen. Verwende ## für Hauptabschnitte und ### für Unterabschnitte. Umschließe ein Wort mit zwei Sternchen für fett oder einem für kursiv; drei kombinieren beides. Achte auf passende Markierungen auf beiden Seiten. Zusätzliche Sternchen machen den Quelltext schwerer lesbar und können ändern, wie der Parser ihn interpretiert.

# Projektbriefing

## Das Ziel

Mache den **wichtigen Punkt** deutlich.
Setze *Betonung* sparsam ein, oder ***kombiniere beides***.

- Erste Maßnahme
- Zweite Maßnahme

Lass eine Leerzeile zwischen Absätzen und rund um Listen. Ein Zeilenumbruch im Quelltext ist nicht immer ein neuer Absatz im PDF. Einheitliche Überschriften machen zudem ein automatisch erzeugtes Inhaltsverzeichnis nützlicher.

3. Halte Tabellen und Code übersichtlich

Tabellen eignen sich für kurze Vergleiche. Füge unter den Spaltennamen eine Trennzeile ein und halte jede Zelle knapp. Eine breite Tabelle, die auf einem Monitor angenehm wirkt, kann auf Papier eng werden. Teile einen großen Vergleich in kleinere Tabellen auf oder verschiebe lange Erklärungen in den Absatz darunter.

| Aufgabe | Status |
| --- | --- |
| Entwurf | Abgeschlossen |
| Review | In Arbeit |

```javascript
const total = 3 * 4;
console.log(total);
```

Nutze eingezäunte Codeblöcke für mehrzeilige Beispiele und Backticks für einen kurzen Inline-Befehl. Kürze sehr lange Codezeilen vor dem Export; die gedruckte Seite kann sich nicht wie dein Editor horizontal erweitern.

4. Füge Bilder hinzu, die ins Dokument gehören

Ein Bild besteht aus einem Ausrufezeichen, beschreibendem Text in eckigen Klammern und seiner Quelle in runden Klammern. Ersetze die Beispieladresse unten durch dein eigenes Bild. Mit dem Bilder-Werkzeug kannst du außerdem eine lokale PNG-, JPEG-, GIF- oder WebP-Datei auswählen; sie wird direkt ins Markdown eingebettet. Schreibe einen nützlichen Alternativtext, statt einen unerklärten Dateinamen stehen zu lassen.

![Projektzeitplan mit drei Meilensteinen](https://example.com/timeline.png)

Prüfe vor dem Herunterladen, ob jedes Bild angezeigt wird. Ein externes Bild benötigt möglicherweise eine Berechtigung oder kann nicht mehr verfügbar sein; ein lokaler Dateipfad von deinem Computer steht dem Export-Server nicht automatisch zur Verfügung. Bevorzuge passend große Bilder gegenüber sehr großen Originalen.

Diagramme, Mathematik und Seitenumbrüche

Ein eingezäunter Block mit der Sprache mermaid wird zu einem Diagramm. TeX zwischen einfachen Dollarzeichen ist Inline-Mathematik, zwischen doppelten Dollarzeichen auf eigenen Zeilen eine zentrierte Formel. Eine Zeile mit nur \newpage erzwingt eine neue Seite. Ein Frontmatter-Block ganz oben legt Titel, Untertitel, Autor, Datum und Schlagwörter fest, die für das Deckblatt und die PDF-Eigenschaften verwendet werden.

---
title: Spezifikation Zahlungsdienst
author: Sam
---

```mermaid
flowchart LR
  A[Bestellung] --> B[Belastung] --> C[Beleg]
```

Die Wartezeit nach Versuch $n$ beträgt $w_n = 2^n \cdot 250$ ms.

\newpage

Diagramme werden in deinem Browser gezeichnet und mit der PDF-Anfrage gesendet, sodass nichts zum Diagramm auf dem Server gespeichert wird.

5. Lege das Seitenlayout vor der finalen Prüfung fest

Wähle A4, A5 oder Letter und dann den Dokumentstil Klar, Redaktionell oder Technisch. Diese Einstellungen wirken sich auf das exportierte Dokument aus. Komfortable, kompakte und großzügige Ränder bieten schnelle Ausgangspunkte; benutzerdefinierte Ränder lassen dich jede Seite in Millimetern anpassen. Lass Platz für wiederkehrende Kopf- und Fußzeilen, falls du sie verwendest.

Aktiviere bei einem längeren Dokument ein Inhaltsverzeichnis; es nutzt die ersten drei Überschriftenebenen. Prüfe Seitenzahlen sowie Marken-Text oder -Logo. Der Wechsel der Website zwischen hellem und dunklem Modus ist eine Lesevorliebe, keine Aufforderung, das Dokument mit dunklem Hintergrund zu drucken.

6. Exportieren, prüfen und herunterladen

Erzeuge das PDF, sobald die Vorschau stimmig wirkt. Die Live-Vorschau ist beim Bearbeiten hilfreich; das erzeugte PDF ist die letzte Kontrolle für Seitenumbrüche, Bildplatzierung und wiederkehrende Inhalte. Öffne es und prüfe die erste Seite, eine Seite mit einer Tabelle und die letzte Seite, bevor du es teilst.

Normaler Dokumenttext bleibt im PDF auswählbar. MDPress leitet den Dateinamen für den Download aus deiner ersten Hauptüberschrift ab, andernfalls aus einer weiteren Überschrift oder der ersten nicht leeren Zeile. Aus „Projektbriefing“ wird zum Beispiel „projektbriefing.pdf“. Wähle einen klaren Titel, damit die Datei auch außerhalb deines Download-Ordners Sinn ergibt.

Häufige Formatierungsprobleme zum Prüfen

Wirkt die Formatierung falsch, prüfe auf einen nicht geschlossenen Codeblock, nicht passende Hervorhebungsmarkierungen oder eine fehlende Leerzeile. Wirkt der Inhalt gedrängt, kürze Tabellenzellen oder passe Seitenformat und Ränder an. Rohes HTML wird als Text behandelt, und ein vorangestellter YAML-Frontmatter-Block wird entfernt; nutze für unterstützte Druckeinstellungen die Dokumentsteuerung, statt eingebettetes HTML oder Frontmatter zur Konfiguration des Exports zu erwarten.

Wohin dein Entwurf und dein Export gehen

Entwurfstext, Einstellungen und gespeicherte Voreinstellungen nutzen den lokalen Speicher dieses Browsers. Sie sind kein Cloud-Backup und können verschwinden, wenn du Browserdaten löschst. Der Export sendet dein Markdown und deine Dokumenteinstellungen an den MDPress-Server, um das PDF zu erzeugen. Lade eine Markdown-Kopie herunter, wenn du eine wiederverwendbare Quelldatei möchtest, besonders vor einem Gerätewechsel.