CDRN

Ein PDF in Base64 encodieren

  • Dashboard
  • Dokumentation
  • API
konvertiert ein PDF in einen Base64- / Data-URI-String, ideal zum direkten Einbetten eines Dokuments in HTML, JSON oder eine E-Mail

Eine PDF in Base64 kodieren

Base64 ist eine Kodierung, die binäre Daten als ASCII-Text darstellt (64 Zeichen: A-Z, a-z, 0-9, plus zwei zusätzliche Zeichen). Eine PDF-Datei, die von Natur aus binär ist, kann nicht direkt in eine HTML-E-Mail, eine JSON-Payload oder ein XML-Attribut eingefügt werden: sie muss zunächst in Text konvertiert werden. Unser Tool nimmt Ihre PDF-Datei und gibt ihre Base64-Darstellung zurück, bereit zum Kopieren.

Für Details zu Base64 und dem Data-URI-Format im Allgemeinen besuchen Sie unseren Base64-Text-Encoder, der die Grundlagen ausführlich behandelt.

Warum eine PDF in Base64 kodieren?

  • Eine PDF in eine HTML-E-Mail einbetten: einige Mail-Clients akzeptieren Data-URI-Links oder inline-kodierte MIME-Anhänge.
  • Eine PDF in einem Textfeld einer Datenbank speichern (Spalte TEXT oder VARCHAR), wenn die Anwendungseinschränkung einen Binärtyp (BLOB) verbietet.
  • Eine PDF in einer JSON-API-Payload übertragen: JSON unterstützt kein Binär, daher muss jede Datei als Base64 übertragen werden.
  • Eine PDF in eine data:-URL einbetten: seltene Nutzung, für sehr kleine Dateien reserviert, da URLs Längenbeschränkungen haben (typischerweise 2000 bis 8000 Zeichen je nach Browser und Server).

Data-URI-Format für PDF

Eine Data-URI-URL bettet den PDF-Inhalt direkt in die URL ein: 

data:application/pdf;base64,JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFI...

Das Präfix data:application/pdf;base64, zeigt dem Browser den MIME-Typ und die Kodierung an. Sie können diese URL direkt in die Adressleiste eines modernen Browsers einfügen, um die PDF zu öffnen, oder sie in das Attribut src eines <iframe> oder <embed> platzieren.

Konkrete Anwendungsfälle

  • Elektronische Signaturen: die meisten Signatur-APIs (DocuSign, Yousign usw.) akzeptieren oder erfordern die PDF als Base64 im JSON-Anfrage-Body.
  • Backups und Archivierung: eine PDF in einem JSON-Export oder einer in Git versionierten Textdatei serialisieren (bei großen Mengen zu vermeiden, aber praktisch für Test-Fixtures).
  • Automatisierte Tests: eine Referenz-PDF direkt in einem Unit-Test einbinden, ohne von einer externen Datei abhängig zu sein.
  • Client-Exporte: eine PDF serverseitig generieren, als Base64 in der JSON-Antwort zurückgeben, der Client dekodiert sie und lädt sie ohne zusätzlichen HTTP-Aufruf herunter.

Bekannte Nachteile

  • Größenoverhead: Base64 fügt etwa 33 % zum Volumen hinzu. Eine 1 MB große PDF wird zu einer 1,37 MB großen Base64-Zeichenkette.
  • Kein HTTP-Cache: eine als Data-URI in eine HTML-Seite eingebettete PDF wird bei jedem Laden neu heruntergeladen, im Gegensatz zu einer Datei, die von einer klassischen URL mit Cache-Headern ausgeliefert wird.
  • Größenbeschränkungen: der Browser-Speicher, die maximale POST-Größe auf der Serverseite (upload_max_filesize und post_max_size in PHP) und die Datenbankkontingente (MySQL-Zeilengröße beispielsweise) können bei großen PDFs schnell überschritten werden.
  • Nicht geeignet für große Dateien: jenseits einiger MB einen dedizierten Speicher (S3, Festplatte) bevorzugen und eine URL statt des kodierten Inhalts übertragen.

Verwendung des Tools

  1. Klicken Sie auf das Upload-Feld und wählen Sie Ihre PDF-Datei aus.
  2. Das Tool kodiert den binären Inhalt in Base64 und zeigt das Ergebnis an.
  3. Sie können wählen, ob Sie das Präfix data:application/pdf;base64, einschließen möchten oder nicht, je nach Ihrem Anwendungsfall (mit Präfix für eine Data-URI, ohne Präfix für eine JSON-Payload).
  4. Kopieren Sie die Zeichenkette und fügen Sie sie dort ein, wo Sie sie benötigen.

Häufig gestellte Fragen

Welche maximale PDF-Größe wird akzeptiert?

Das Limit hängt von der Serverkonfiguration ab. Bleiben Sie in der Praxis unter einigen MB, um ein flüssiges Erlebnis zu gewährleisten. Darüber hinaus verlangsamt sich der Browser, die Zwischenablage sättigt sich, und die Ziele (E-Mail, JSON, Datenbank) riskieren, die Last abzulehnen.

Ist Base64-PDF mit Mail-Clients (Gmail, Outlook) kompatibel?

Als inline-kodierter Anhang in einer MIME-Nachricht: ja, das ist sogar der Standard-Mechanismus für elektronische Post. Dagegen blockieren oder überschreiben die meisten Mail-Clients Data-URIs im HTML-Körper einer Nachricht (<a href="data:..."> oder <iframe>) aus Sicherheitsgründen. Klassische Anhänge bevorzugen.

Was ist der Unterschied zu einer verschlüsselten PDF?

Base64-Kodierung ist keine Verschlüsselung: die Zeichenkette bleibt lesbar und trivial von jedermann dekodierbar. Eine verschlüsselte PDF (Besitzer- oder Benutzerpasswort) bleibt auch nach Base64-Kodierung verschlüsselt: Kodierung und Verschlüsselung sind zwei unabhängige Operationen.

Kann ich die umgekehrte Operation durchführen?

Ja: verwenden Sie unseren Base64-PDF-Dekoder, um eine Base64-Zeichenkette in eine herunterladbare PDF-Datei umzuwandeln.

Wird meine PDF an Ihre Server gesendet?

Die Kodierung wird für die Dauer der Anfrage serverseitig verarbeitet, dann wird die Datei freigegeben. Es wird kein persistenter Speicher verwendet. Für besonders sensible PDFs empfehlen wir eine lokale Verarbeitung mit einem Offline-Tool.

Beispielanfrage

curl -X POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute \
  -F "file=@/path/to/file"

Eingabeschema

Feld Typ Erforderlich Standard
file file ✓ –

dieses Tool erwartet eine Datei - verwenden Sie Content-Type multipart/form-data anstelle von application/json

Endpunkte

  • GET https://cdrn.fr/api/v1/tools - listet alle verfügbaren Tools auf
  • GET https://cdrn.fr/api/v1/tools/base64-pdf-encoder - liefert das Schema dieses Tools
  • POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute - führt dieses Tool mit einem JSON-Payload aus