DOKUMENTATION

Markdown in PDF umwandeln: Anleitung

Diese Anleitung führt dich vom Import über die Formatprüfung bis zur Kontrolle der fertigen PDF-Seiten. Ein Benutzerkonto ist nicht erforderlich.

Konverter öffnen

01 / 08

Datei hochladen oder Text einfügen

Ein vorhandenes Markdown-Dokument lässt sich direkt im einfachen Modus umwandeln.

Datei auswählen

Wähle eine UTF-8-Datei mit der Endung .md oder .markdown aus oder ziehe sie in den Upload-Bereich. Benötigt das Dokument lokale Bilder, füge die unterstützten Bilddateien gleich mit hinzu. Kontrolliere Dateiname und Bereitschaftsanzeige, bevor du PDF herunterladen auswählst.

Text einfügen

Über Schreiben oder Einfügen öffnest du den Editor und setzt deinen Markdown-Text ein. Bearbeiten und Anpassen zeigt den vollständigen Arbeitsbereich, ohne ein geladenes Dokument zu löschen. Bei Bedarf änderst du den PDF-Dateinamen. Für die PDF-Erstellung wird eine Serververbindung benötigt.

Zurück nach oben

02 / 08

Bearbeiten, prüfen und herunterladen

Editor und HTML-Vorschau laufen lokal im Browser; das eigentliche PDF erstellt der Server.

Markdown kontrollieren

Wechsle im erweiterten Arbeitsbereich zwischen Schreiben und Vorschau. Prüfe Überschriften, Einrückungen, Tabellen und Links. Auf schmalen Bildschirmen sind die Ansichten einzeln verfügbar. Die HTML-Vorschau aktualisiert sich, ohne den Dokumenttext zu übertragen.

Herunterladen und prüfen

Wähle PDF herunterladen und öffne die heruntergeladene Datei, um Seitenumbrüche, Ränder und die letzte Seite zu prüfen. Die Live-Vorschau zeigt die Seiteneinteilung nur ungefähr. Lade nach Änderungen eine neue PDF herunter. Auch die Markdown-Datei lässt sich herunterladen.

Zurück nach oben

03 / 08

Unterstützte Syntax, Formeln und Diagramme

Übliche Markdown-Elemente funktionieren direkt; komplexere Erweiterungen unterliegen Grenzen.

Text und Code

Nutze # und ## für Überschriften, - für Listen, - [ ] für Aufgaben, > für Zitate und senkrechte Striche für Tabellen. Codeblöcke mit Begrenzungszeichen werden unterstützt, darunter Hervorhebung gängiger Programmiersprachen. Auch Links sowie Fett- und Kursivtext sind möglich.

KaTeX und Mermaid

Kompatible Mathematik wird mit KaTeX dargestellt. Ein Codeblock mit der Sprachkennung mermaid erzeugt unterstützte Diagramme. Pro Dokument sind bis zu acht Diagramme mit begrenzter Komplexität erlaubt. Bei nicht unterstützten Eingaben kann der Quelltext mit einem Hinweis erscheinen.

Gezielter Seitenumbruch

Setze <!-- pagebreak --> allein in eine Zeile, um eine neue PDF-Seite zu beginnen. --- erzeugt eine Trennlinie. Prüfe die heruntergeladene PDF; bei breiten Tabellen hilft Querformat.

Markdown-Beispiel
# Project notes

A **short report** with [a link](https://example.org).

- [x] Draft complete
- [ ] Review PDF

| Item | Status |
| --- | --- |
| Export | Ready |

```ts
const format = "pdf";
```

Inline math: $E = mc^2$

```mermaid
flowchart LR
  A[Markdown] --> B[PDF]
```
Zurück nach oben

04 / 08

Bilder anhängen und Verweise reparieren

Ein Markdown-Bildverweis benötigt zusätzlich die tatsächliche Bilddatei.

Lokale Bilddateien

Schreibe beispielsweise ![Grafik](grafik.png) und hänge die zugehörige PNG-, JPEG- oder WebP-Datei an. Markdown und Bilder lassen sich zusammen ablegen. Die automatische Zuordnung über Dateinamen gelingt nur bei eindeutigem Treffer. Andernfalls verwende das Anhängen-Steuerelement am offenen Verweis.

Externe Bilder

HTTPS-Bildadressen werden nicht automatisch aufgerufen. Mit Von URL laden stellt dein Browser selbst die Verbindung zum Bildhost her; dieser muss CORS erlauben. Falls das nicht funktioniert, hänge eine lokale Kopie an. Bei fehlenden Bildern erscheinen im PDF beschriftete Platzhalter.

Markdown-Beispiel
![Architecture](images/architecture.png)
Zurück nach oben

05 / 08

Papierformat und Seitenbild einstellen

Die Layout-Einstellungen sind im Editor unter der Schrift- und Farbauswahl immer sichtbar. Sie ändern das gedruckte Dokument, nicht das Erscheinungsbild der Website.

Seiten- und Texteinstellungen

Zur Wahl stehen A4 und US Letter, Hoch- und Querformat sowie die Dokumentstile Clean, Technical und Editorial. Schriftgrößen sind 9, 10, 11, 12, 14 oder 16 pt; die Ränder können 12, 18 oder 24 mm betragen. Seitenzahlen lassen sich einblenden und die Standardwerte zurücksetzen. Editorial ergänzt Serifentypografie und leichtere Tabellenlinien. Die Schrift folgt dem Stil oder verwendet Inter, Lora oder JetBrains Mono. Akzentfarben sind Waldgrün, Marineblau, Weinrot und Monochrom; Zeilenabstände sind Kompakt, Ausgewogen und Großzügig. Alle Optionen gelten für Vorschau und PDF.

Umbrüche überprüfen

Breite Tabellen, lange Codeblöcke und Diagramme verändern die Seitenaufteilung. Erzeuge ein PDF und prüfe die betroffenen Stellen. Eventuell helfen Querformat, kleinere Schrift oder schmalere Ränder. Die Website-Darstellung bleibt vom PDF-Layout getrennt.

Seitenumbruch-Markierung
<!-- pagebreak -->
Zurück nach oben

06 / 08

Grenzwerte und nicht verfügbare Funktionen

Die Beschränkungen begrenzen den Ressourcenverbrauch. Sie garantieren keine erfolgreiche Ausgabe besonders komplexer Dokumente.

Dateien und Bilder

Markdown ist auf 250 KB begrenzt. Maximal 12 PNG-, JPEG- oder WebP-Bilder sind erlaubt, zusammen höchstens 2 MB. Ein Bild darf maximal 16 Megapixel und 8.000 Pixel pro Seite haben. Bis zu acht Mermaid-Diagramme sind unter Komplexitätsgrenzen möglich.

Zeit und Anfragen

Für das Einlesen gilt eine Grenze von 10 Sekunden, für die PDF-Erstellung von 30 Sekunden. Außerdem gibt es vorübergehende Limits für Anfragen und gleichzeitige Umwandlungen. Auch ein Dokument innerhalb der Dateigrenzen kann zu aufwendig sein.

Nicht enthalten

Import per Repository-URL, Ordner oder ZIP, Stapelverarbeitung, Konten, gespeicherte Entwürfe, öffentliche Dateilinks und eine API gibt es nicht. Eigene HTML-Elemente, Skripte, CSS und Schriften werden nicht unterstützt. Eine PDF/A- oder PDF/UA-Zertifizierung ist nicht zugesichert.

Zurück nach oben

07 / 08

Häufige Probleme lösen

Scheitert die Erstellung, bleibt dein Markdown im Editor und lässt sich korrigieren.

Bilder oder Diagramme fehlen

Prüfe die betroffenen Bildverweise und hänge die korrekten Dateien an. Blockiert CORS eine Online-Grafik, verwende eine lokale Kopie. Vereinfache zu große Mermaid-Diagramme und entferne nicht unterstützte Konfiguration. Lies vorhandene Warnungen vor dem Download.

Seiten sind ungünstig aufgeteilt

Bei abgeschnittenen Tabellen oder ungünstigen Codeumbrüchen probiere Querformat, kleinere Schrift und schmalere Ränder. Für einen festen Seitenwechsel muss <!-- pagebreak --> allein in der Zeile stehen. Erzeuge die PDF erneut und prüfe die echten Seiten.

Fehler oder veraltete PDF

Kontrolliere die Größen- und Bildlimits und starte einen neuen Versuch. Bei einem Anfragelimit warte kurz. Nach Text- oder Layoutänderungen brauchst du eine neu erzeugte PDF. Abbrechen beendet das Warten im Browser; die bereits gestartete Serverarbeit kann weiterlaufen.

Zurück nach oben

08 / 08

Umgang mit deinen Dokumenten

Während des Schreibens bleiben die Daten im Browser. Zur PDF-Erstellung werden sie übertragen.

Während der Bearbeitung

Markdown und Bilder bleiben beim Bearbeiten in diesem Tab. Neuladen oder Schließen verwirft ungespeicherte Arbeit; lade Markdown zum Aufbewahren herunter. Standard ist der helle Modus. Dieser Browser merkt sich Darstellung und Bearbeitungsmodus; Dokumentinhalte werden nicht im Browserspeicher gespeichert.

Bei der PDF-Erstellung

PDF herunterladen sendet Markdown, Bilder und Layout an den Konvertierungsserver. Die App bewahrt Dokumente nicht absichtlich auf, veröffentlicht keine PDFs und protokolliert keine Dokumentinhalte. Details zum Hosting stehen auf der Datenschutzseite.

Zurück nach oben

Markdown in PDF umwandeln

Konverter öffnen