md in pdf: Markdown zu PDF

So funktioniert es

1. 1Fügen Sie Ihr Markdown in das Feld ein oder öffnen Sie eine .md-, .markdown- oder .txt-Datei von Ihrem Gerät.
2. 2Prüfen Sie die Vorschau. Sie zeigt das Dokument, bevor Sie es umwandeln.
3. 3Wählen Sie Seitenformat, Rand, Textgröße und Ausrichtung.
4. 4Klicken Sie auf „Umwandeln“. Bei anonymer Nutzung müssen Sie zuerst eine Sicherheitsprüfung bestehen. Angemeldete Nutzer überspringen sie.
5. 5Laden Sie das PDF herunter. Ergebnisse werden nach 10 Minuten gelöscht, speichern Sie die Datei daher kurz nach der Umwandlung.

Beispielergebnis

So wandeln Sie Markdown in PDF um (md in pdf)

Dieser Markdown-in-PDF-Konverter arbeitet in drei Schritten. Zuerst wird Ihr Markdown in Ihrem Browser-Tab in HTML umgewandelt. Danach wird das bereinigte HTML an unsere Render-Engine gesendet, die es mit Headless-Chromium (Chromium ohne Bedienoberfläche) als PDF druckt. Zum Schluss laden Sie die Datei herunter.

Sie müssen keine Software installieren und kein Konto anlegen. Anonyme Nutzung erfordert eine Sicherheitsprüfung. Angemeldete Nutzer überspringen die Prüfung und verwenden Credits. Wir fügen kein Wasserzeichen hinzu.

Das PDF verwendet eine serifenlose Schrift, Überschriften mit einer Linie unter den beiden obersten Ebenen, graue Codeblöcke, Tabellen mit Rahmen und formatierte Zitate. Sie müssen Ihrem Markdown keine Formatierung hinzufügen.

Welches Markdown funktioniert

Der Konverter verwendet GitHub Flavored Markdown, daher sind folgende Funktionen aktiviert:

• Tabellen, mit Rahmen gedruckt
• Aufgabenlisten, geschrieben als - [ ] für einen offenen Punkt und - [x] für einen erledigten Punkt
• Durchgestrichener Text
• Automatische Links, etwa eine nackte Webadresse
• Im Markdown eingetipptes HTML wird vor dem Drucken bereinigt. Skripte und Ereignisattribute werden entfernt, sodass sie im PDF nicht ausgeführt werden.

README-Dateien und Bilder

Sie können eine README.md-Datei direkt umwandeln. Öffnen Sie die Datei oder fügen Sie ihren Text ein, dann bleiben Überschriften, Listen, Tabellen und Codeblöcke in ihrer Struktur erhalten.

Bilder funktionieren, wenn die Adresse ein öffentlicher Link mit https:// oder http:// oder eine data:-URL ist. Relative Pfade wie ./img/a.png werden nicht geladen, weil der Konverter den Ordner Ihrer Datei nicht sehen kann.

Wenn ein Bild im PDF fehlt, öffnen Sie seine Adresse zuerst in einem neuen Browser-Tab. Ein Link, der bei Ihnen nicht öffnet, wird auch im PDF nicht geladen.

Codeblöcke und Tabellen

Ein abgegrenzter Codeblock erhält Syntaxfarben, wenn Sie die Sprache nach der öffnenden Begrenzungszeile angeben, zum Beispiel python. Farben funktionieren für JavaScript, TypeScript, Python, JSON, Shell, CSS, HTML und XML, SQL, Go, Rust, Java, C, C++, C#, PHP, Ruby, YAML, Markdown, Diff, Kotlin und Swift.

Ein Codeblock ohne Sprache oder mit einer Sprache, die nicht in dieser Liste steht, wird als einfacher Text auf grauem Hintergrund gedruckt.

Breite Tabellen brauchen Platz. Wählen Sie bei einer Tabelle mit vielen Spalten das Querformat, damit jede Zeile mehr Breite hat.

Seitenformat, Rand und Textgröße

Wählen Sie als Seitenformat A4, Letter, Legal, A3 oder A5. Stellen Sie den Rand in Millimetern ein.

Stellen Sie die Textgröße zwischen 9 und 14 pt ein. Eine kleinere Größe passt mehr Text auf eine Seite, eine größere ist auf Papier leichter zu lesen.

Sie können außerdem das Querformat einschalten und wählen, ob Hintergründe gedruckt werden. Zu den Hintergründen gehören die grauen Codeblöcke.

Was das Tool nicht kann

Dieses Tool ist für Markdown-Dokumente gedacht. Folgende Funktionen werden nicht unterstützt:

• LaTeX-Formeln werden nicht dargestellt.
• Mermaid-Diagramme werden nicht gezeichnet.
• Fußnoten werden nicht unterstützt.
• Front Matter am Anfang einer Datei wird nicht verarbeitet.
• Das Web-Tool fügt kein Inhaltsverzeichnis, keine Seitenzahlen und keine Kopf- oder Fußzeilen hinzu.
• Die API kann Kopf- und Fußzeilen hinzufügen. Ihre Vorlagen für Kopf- und Fußzeilen können Seitenzahlen anzeigen, wie im API-Abschnitt weiter unten beschrieben.

Wo die Umwandlung stattfindet

Ihr Markdown wird in Ihrem Browser gelesen und in HTML umgewandelt. Das HTML wird dort bereinigt und danach an die Render-Engine gesendet. Die .md-Datei selbst erhält die Render-Engine nicht.

Die Engine lädt das HTML in Headless-Chromium innerhalb eines ressourcenbegrenzten Worker-Containers, mit einer festen Zeitgrenze für jeden Auftrag. Sie druckt die Seite als PDF und hält das Ergebnis zum Herunterladen bereit. Jede Umwandlung erhält einen neuen Browser-Kontext, daher werden Cookies und Cache nicht zwischen Aufträgen geteilt.

Das Ergebnis wird nach 10 Minuten gelöscht. Ein Datensatz zu jedem Auftrag wird gespeichert, und angemeldete Nutzer können ihre Aufträge im Dashboard einsehen.

Markdown-in-PDF-API

Um Markdown in Ihrem eigenen Code umzuwandeln, wandeln Sie das Markdown mit einer Markdown-Bibliothek Ihrer Sprache in HTML um und senden Sie das HTML dann als html_to_pdf-Anfrage an die API. Das ist die Markdown-in-PDF-API in Kürze: Die API nimmt HTML entgegen, nicht Markdown, daher bleibt der erste Schritt in Ihrem Code. Senden Sie Ihren API-Schlüssel als Bearer-Token im Header Authorization. Die Anfrage sieht so aus:

curl -X POST https://api.aiipworld.com/v1/render \
  -H "Authorization: Bearer $AIIPWORLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html":"<h1>Release notes</h1><p>This HTML came from a Markdown file.</p>","output":"pdf","options":{"format":"A4"}}'

# returns {"job_id": "...", "status": "queued"}; then poll:
curl https://api.aiipworld.com/v1/jobs/JOB_ID -H "Authorization: Bearer $AIIPWORLD_API_KEY"

Der Render-Aufruf gibt 202 mit einer job_id zurück. Fragen Sie GET /v1/jobs/:id ab, bis der Status succeeded, failed oder timeout lautet. Laden Sie die Datei dann von download_url herunter, einem kurzlebigen signierten Link.

Diese Node.js-Version verwendet marked, die Bibliothek, die auch das Web-Tool nutzt, um eine README.md in HTML umzuwandeln. Sie fügt ein kleines style-Element hinzu, mit dem Sie Ihr eigenes CSS auf das PDF anwenden, und sendet die Seite dann an die API. Markdown kann rohes HTML enthalten, bereinigen Sie es daher zuerst, wenn der Text nicht von Ihnen stammt. Das Web-Tool macht das in Ihrem Browser mit DOMPurify.

// npm install marked
import { readFile } from "node:fs/promises";
import { marked } from "marked";
import { render } from "./aiipworld-pdf.mjs";

const markdown = await readFile("README.md", "utf8");
const css = `body { font-family: "Liberation Sans", Arial, sans-serif; line-height: 1.5; }
pre { background: #f3f4f6; padding: 8px; white-space: pre-wrap; }
table { border-collapse: collapse; } th, td { border: 1px solid #d9dbe8; padding: 4px 8px; }`;
const html = `<!doctype html><html><head><meta charset="utf-8"><style>${css}</style></head><body>${marked.parse(markdown)}</body></html>`;

const job = await render({ html, output: "pdf", options: { format: "A4" } }, "readme.pdf");
console.log(job.status, job.result.pages, "pages");

Credits für fehlgeschlagene Aufträge und Aufträge mit Zeitüberschreitung werden zurückerstattet. Es gibt keinen Stapel-Endpoint, daher senden Sie eine Anfrage pro Dokument. Webhooks und Vorlagen mit JSON-Daten sind noch nicht verfügbar. Die API kann außerdem Kopf- und Fußzeilen und Seitenzahlen hinzufügen, was das Web-Tool nicht kann.

README- oder GitHub-Markdown-Datei verwenden

Wenn Sie eine README-Datei als PDF zum Teilen mit anderen brauchen, öffnen Sie die README.md-Datei oder fügen Sie ihren Text hier ein. Überschriften, Listen und Codeblöcke bleiben in ihrer Struktur erhalten, sodass das Dokument auf Papier lesbar bleibt.

Wenn Sie eine GitHub-Markdown-Datei in PDF umwandeln, arbeitet der Konverter mit den GitHub-Flavored-Markdown-Funktionen, die er unterstützt: Tabellen, Aufgabenlisten, Durchstreichungen und automatische Links. Das PDF nutzt ein eigenes Dokumentdesign und entspricht daher nicht genau der Seitengestaltung von GitHub.

Schriftarten und nicht englischer Text

Das PDF verwendet die Schriftarten des Render-Servers. Auf Ihrem Gerät installierte Schriftarten stehen nicht zur Verfügung, daher kann das Ergebnis anders aussehen als in Ihrem Editor.

Zeichen, die eine Serverschrift abdeckt, werden im PDF gedruckt, auch Chinesisch, Japanisch und Koreanisch. Emoji werden mit Noto Color Emoji gezeichnet.

MD-Dateien: .md online in PDF umwandeln

Eine .md-Datei ist eine einfache Textdatei, die in Markdown geschrieben ist. Dieser Konverter liest sie als Text: Öffnen Sie die Datei oder fügen Sie ihren Inhalt ein, prüfen Sie die Vorschau und wandeln Sie um. Wenn Sie markdown in pdf umwandeln möchten, brauchen Sie weder einen Editor noch ein Konto.

Die Umwandlung einer md-Datei in PDF macht Ihr Markdown in Ihrem Browser-Tab zu HTML, und unser Render-Server druckt dieses HTML als PDF. Das Tool funktioniert daher auf jedem Gerät mit Browser. Wenn Sie die Umwandlung mit einem anderen Seitenformat oder Rand wünschen, ändern Sie diese Einstellungen und wandeln Sie erneut um.

Fragen