PDFVela — pdfvela.com
Wszystkie narzędzia PDF

Jak osadzić obraz w HTML lub CSS za pomocą Base64?

Jeden plik zamiast dwóch – kiedy Data URI to dobry wybór i jak go używać, żeby nie spowolnić strony

Autor: · Zaktualizowano 10 listopada 2026

Czym jest Data URI

Zwykle strona HTML wskazuje na osobny plik z obrazem, a przeglądarka pobiera go drugim żądaniem. Data URI umieszcza sam obraz w stronie jako tekst. Zaczyna się od krótkiej etykiety określającej typ pliku, po której następuje plik zapisany w Base64:

data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA…

Wszędzie tam, gdzie przeglądarka przyjmuje adres obrazu – w atrybucie src znacznika img, w url() w CSS czy w linku do ikony favicon – przyjmie też Data URI.

1. Zamień obraz na Base64

Otwórz Obraz na Base64, wybierz obraz (JPG, PNG, WebP, GIF, SVG, ICO, BMP lub AVIF) i wskaż potrzebny format:

Chcesz…Wybierz
Wstawić obraz do strony HTMLZnacznik HTML img gotowy do wklejenia
Użyć go jako tła w arkuszu stylówReguła CSS background-image
Wkleić go do JSON, Markdown lub pola formularzaData URI
Wysłać go do API, które wymaga samego koduSam kod Base64, bez prefiksu

Kliknij Zamień na Base64, a potem Kopiuj tekst. Przy długich wynikach bezpieczniej jest pobrać plik .txt – zaznaczając bardzo długi wiersz ręcznie, łatwo pominąć jego koniec.

2. Wklej go tam, gdzie potrzebujesz

W HTML znacznik img z narzędzia wklejasz prosto do strony. Wpisz w cudzysłowie sensowny tekst alternatywny (alt), żeby czytniki ekranu mogły opisać obraz.

W CSS wklej regułę do wybranego selektora, np. przycisku albo nagłówka. Pamiętaj, żeby nadać elementowi rozmiar – obraz tła sam nie ustala wielkości elementu.

W JSON lub żądaniu do API wklej Data URI (albo sam kod, jeśli tak mówi dokumentacja) jako wartość tekstową. Najpierw sprawdź limit rozmiaru usługi – wiele API odrzuca żądania większe niż kilka megabajtów.

3. Osadzaj tylko małe obrazy

Tekst Base64 jest o około 33% większy niż oryginalny plik i jest pobierany od nowa za każdym razem, gdy zmienia się strona lub arkusz stylów. Praktyczna zasada:

  • Poniżej 10 KB – ikony, małe logo, proste kształty: osadzanie to dobry pomysł.
  • 10–100 KB – do przyjęcia w dokumentach jednoplikowych, stronach offline i szablonach e-maili.
  • Powyżej 100 KB – na stronie internetowej zostaw obraz jako zwykły plik.

Aby zmniejszyć obraz przed konwersją, użyj narzędzia Kompresuj PNG lub Kompresuj JPG albo zmniejsz jego wymiary w pikselach za pomocą narzędzia Zmień rozmiar zdjęcia. Zdjęcie o szerokości 2000 pikseli wyświetlane w szerokości 300 pikseli marnuje większość swojego rozmiaru.

Najczęstsze błędy

  • Ucięty tekst. Brak jednego znaku na końcu psuje cały obraz. Kopiuj przyciskiem albo pobierz plik .txt.
  • Zły typ w etykiecie. Plik JPG oznaczony jako image/png może wyświetlić się w niektórych przeglądarkach, a w innych nie. Konwerter odczytuje prawdziwy typ z pliku, więc jego etykieta jest zawsze poprawna.
  • Podziały wierszy w kodzie. Niektóre edytory zawijają długie wiersze i wstawiają w nie znaki końca linii. W HTML i CSS Data URI musi pozostać w jednym wierszu.
  • Ogromne obrazy w CSS. Każda strona korzystająca z arkusza stylów pobiera obraz, nawet jeśli go nigdy nie wyświetla. Duże grafiki zostaw jako pliki.

Kiedy nie używać Base64

Zwykłych plików graficznych używaj do zdjęć, do wszystkiego powyżej ok. 100 KB, do obrazów, które mają pojawiać się w wynikach wyszukiwania, oraz do obrazów używanych na wielu stronach (plik trafia do pamięci podręcznej raz, a osadzony tekst powtarza się na każdej stronie). Base64 to narzędzie do małych, samodzielnych elementów – nie zastępuje plików graficznych.

Chcesz spróbować? To nic nie kosztuje, a plik zostaje na Twoim urządzeniu.

Otwórz narzędzie Obraz na Base64

Osadzanie obrazów w Base64 – najczęstsze pytania

Czy obraz w Base64 ładuje się szybciej niż zwykły plik graficzny?

Tylko w przypadku bardzo małych obrazów. Oszczędzasz jedno żądanie sieciowe, ale tekst jest mniej więcej o jedną trzecią większy od pliku i nie da się go osobno zapisać w pamięci podręcznej. Przy ikonach ważących kilka kilobajtów to się opłaca, przy zdjęciach strona zwykle działa wolniej.

Czy wyszukiwarki zobaczą obraz w Base64?

Obraz zapisany jako Data URI nie ma własnego adresu, więc nie pojawi się w wynikach wyszukiwania grafiki. Zdjęcia, które mają być znajdowane, zostaw jako zwykłe pliki, a Base64 używaj do dekoracji, ikon i logo.

Dlaczego obraz widać w przeglądarce, ale nie w e-mailu?

Wiele programów pocztowych ze względów bezpieczeństwa blokuje lub usuwa Data URI. W e-mailach pewniejszy jest obraz umieszczony na serwerze albo załącznik, do którego odwołuje się sama wiadomość. Zawsze najpierw wyślij sobie wiadomość testową.

Czy mogę osadzić SVG bez Base64?

Tak. W HTML możesz wkleić kod svg bezpośrednio do strony. W CSS możesz użyć SVG zakodowanego jako URL zamiast Base64 – często wychodzi nieco krócej. Base64 to najprostsza opcja, która działa zawsze.

Czy mój obraz jest przesyłany podczas konwersji?

Nie. Narzędzie Obraz na Base64 odczytuje plik w przeglądarce i tworzy tekst na Twoim urządzeniu – nic nie jest wysyłane na serwer.