Base64 File Encoder

Was ist Base64-Dateikodierung?

Base64-Dateikodierung konvertiert Binärdateien (PDFs, ZIPs, Bilder, Ausführbare, Schriftarten, Audio) in einfachen ASCII-Text mit dem in RFC 4648 definierten Alphabet. Jede drei Bytes binäre Eingabe werden zu vier Base64-Zeichen und erzeugen eine Textdarstellung für textbasierte Kanäle: JSON-API-Payloads, XML-Dokumente, E-Mail-Körper, HTML-Attribute und Umgebungsvariablen.

Im Gegensatz zur Text-zu-Base64-Kodierung (die auf Strings funktioniert) liest die Datei-zu-Base64-Kodierung den Raw-Byte-Stream jeder Datei unabhängig vom Format. PDFBinär-Header, ZIP-Kompressionsblöcke und PNG-Pixeldaten werden identisch behandelt: als Oktett-Sequenz zur Neucodierung. Das Ergebnis ist immer gültiges ASCII, sicher einzubetten überall wo druckbare Zeichen akzeptiert werden.

Der Trade-off ist die Größe: Base64-Ausgabe ist etwa 33% größer als das Original-Binär. Für ein 1-MB-PDF bedeutet das etwa 1,33 MB Base64-Text. Dieser Overhead ist der Kodierung inhärent und kann nicht vermieden werden. Trotzdem bleibt Base64-Dateikodierung die Standardmethode zum Einbetten von Binärdaten in Text-Only-Formate, spezifiziert in MIME (RFC 2045), Daten-URIs (RFC 2397) und JSON Web Tokens (RFC 7519).

Warum diesen Base64-Datei-Encoder verwenden?

Dieses Tool kodiert Dateien zu Base64 direkt im Browser mit der FileReader-API. Keine Datei wird auf einen Server hochgeladen — die gesamte Konvertierung erfolgt Client-seitig in JavaScript.

Base64-Dateikodierung Anwendungsfälle

Base64-Datei-Größen-Overhead

Base64-Kodierung erhöht die Datengröße um genau ein Drittel. Alle 3 Input-Bytes erzeugen 4 Output-Zeichen (jedes repräsentiert 6 Bits). Padding-Zeichen (=) werden hinzugefügt, wenn die Input-Länge nicht ein Vielfaches von 3 ist. Die Tabelle unten zeigt die Beziehung zwischen Original-Dateigröße und kodierter Output-Größe.

Daten-URI und MIME-Typ Referenz

Ein Daten-URI bettet Dateiinhalt direkt in HTML, CSS oder JavaScript mit dem Format data:[MIME-Typ];base64,[kodierte Daten] ein. Der MIME-Typ teilt dem Browser mit, wie die dekodierten Bytes zu interpretieren sind. Unten sind häufige Datei-Erweiterungen, ihre MIME-Typen und das entsprechende Daten-URI-Präfix.

Code-Beispiele

Diese ausführbaren Beispiele zeigen, wie man eine Binärdatei liest und zu Base64 in JavaScript, Python, Node.js, Bash und Go kodiert. Jedes Snippet erzeugt Standard-Base64 (RFC 4648 Abschnitt 4) mit Padding.

// Read a file from an <input> element and encode to Base64
const input = document.querySelector('input[type="file"]')
input.addEventListener('change', (e) => {
  const file = e.target.files[0]
  const reader = new FileReader()
  reader.onload = () => {
    const base64 = reader.result.split(',')[1]
    console.log(base64) // → "JVBERi0xLjQK..." (raw Base64, no data URI prefix)
  }
  reader.readAsDataURL(file)
})

// Convert a Blob to Base64 with async/await
async function blobToBase64(blob) {
  const buffer = await blob.arrayBuffer()
  const bytes = new Uint8Array(buffer)
  let binary = ''
  bytes.forEach(b => binary += String.fromCharCode(b))
  return btoa(binary) // → standard Base64 string
}

import base64
from pathlib import Path

# Encode a file to Base64
file_bytes = Path('document.pdf').read_bytes()
encoded = base64.b64encode(file_bytes).decode('ascii')
print(encoded[:40])  # → "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PA..."

# Write encoded output to a text file
Path('document.b64.txt').write_text(encoded)

# Build a data URI from a file
mime_type = 'application/pdf'
data_uri = f'data:{mime_type};base64,{encoded}'
print(data_uri[:60])  # → "data:application/pdf;base64,JVBERi0xLj..."

import { readFileSync, writeFileSync } from 'fs'

// Encode a file to Base64
const buffer = readFileSync('archive.zip')
const base64 = buffer.toString('base64')
console.log(base64.length) // → 1398104 (for a ~1 MB file)

// Save Base64 output to a file
writeFileSync('archive.b64.txt', base64)

// Build a data URI
const mime = 'application/zip'
const dataUri = `data:${mime};base64,${base64}`

# Encode a file to Base64 (macOS / Linux)
base64 < document.pdf > document.b64.txt

# Encode with no line wrapping (GNU coreutils)
base64 -w 0 < document.pdf > document.b64.txt

# Encode and copy to clipboard (macOS)
base64 < image.png | pbcopy

# Encode with OpenSSL (available everywhere)
openssl base64 -in archive.zip -out archive.b64.txt

# Pipe directly into curl for API upload
base64 -w 0 < photo.jpg | curl -X POST -d @- https://api.example.com/upload

package main

import (
	"encoding/base64"
	"fmt"
	"os"
)

func main() {
	data, err := os.ReadFile("document.pdf")
	if err != nil {
		panic(err)
	}
	encoded := base64.StdEncoding.EncodeToString(data)
	fmt.Println(len(encoded)) // → 1398104 (for a ~1 MB file)

	// Write to file
	os.WriteFile("document.b64.txt", []byte(encoded), 0644)
}

Häufig gestellte Fragen