Formatowanie JSONL z wcięciami

Formatuj JSONL (JSON Lines), dobierając wcięcia tak, by dane były czytelne. Wszystko działa w 100% w przeglądarce — Twoje dane nigdy jej nie opuszczają.

Dane wejściowe JSONL

Upuść tutaj plik .jsonl lub kliknij, aby wybrać plik

Obsługiwane rozszerzenia: .jsonl, .ndjson, .json, .txt

Opcje

Wcięcia:

Sformatowany wynik

Wklej dane JSONL lub przeciągnij je tutaj, aby je sformatować

Czym jest formatowanie JSONL?

Formatowanie JSONL polega na nadaniu czytelnego układu każdemu obiektowi JSON w pliku. W plikach JSONL każdy obiekt jest zwykle zapisany w jednej linii, w zwartej postaci. Formatowanie rozpisuje go na wiele linii z odpowiednimi wcięciami, dzięki czemu widać zagnieżdżone struktury i łatwiej przejrzeć dane.

Przydaje się to zwłaszcza przy debugowaniu odpowiedzi API, przeglądaniu plików logów czy przygotowywaniu danych do dokumentacji. Możesz wybrać wcięcia (2 spacje, 4 spacje lub tabulatory) i opcjonalnie posortować klucze alfabetycznie, aby zachować jednolitą kolejność.

Czytelny układ do przeglądania, kompaktowy zapis do przechowywania

Każdy użytkownik formatera JSONL prędzej czy później natrafia na ten problem: rekord sformatowany z wcięciami zajmuje wiele linii, a taki zapis nie jest już poprawnym JSONL. Dlatego narzędzie udostępnia dwa widoki tych samych danych, z których każdy przekształca zapis w jedną stronę, zamiast jednego przełącznika:

# Jeden rekord, zapis kompaktowy (prawidłowy JSONL — dokładnie jedna linia):
{"event":"signup","user":{"id":831,"plan":"pro"},"ts":"2026-07-14T09:31:22Z"}


# Ten sam rekord, sformatowany z wcięciami (do czytania — NIE jest już prawidłowym JSONL):
{
  "event": "signup",
  "user": {
    "id": 831,
    "plan": "pro"
  },
  "ts": "2026-07-14T09:31:22Z"
}

Używaj trybu z wcięciami do przeglądania rekordów i debugowania, a przed zapisaniem wróć do trybu kompaktowego (minifikacji). Kompaktowy wynik gwarantuje zachowanie zasady „jeden rekord na linię”, na której opiera się każde narzędzie odczytujące JSONL.

Jak sformatować JSONL

Podczas formatowania każda linia pliku JSONL jest parsowana jako obiekt JSON, a następnie ponownie serializowana z wybranymi wcięciami. Dzięki temu łatwiej czytać dane i szukać w nich błędów.

Nasz formater działa w całości w Twojej przeglądarce. Żadne dane nie trafiają na serwer. Wystarczy wkleić tekst JSONL lub przeciągnąć i upuścić plik, a następnie wybrać opcje formatowania — czytelnie sformatowany wynik pojawi się od razu.

Linie z błędami pozostają bez zmian i są zgłaszane osobno, więc nie tracisz żadnych danych. Możesz też włączyć tryb kompaktowy, który minifikuje każdą linię, zmniejszając rozmiar pliku.

Co dokładnie zmieniają poszczególne opcje

Wcięcia: 2 / 4 / tabulator
To wyłącznie preferencja sposobu wyświetlania, z jedną rzeczywistą konsekwencją: rozmiarem pliku. Dla typowego zagnieżdżonego rekordu wcięcie czterema spacjami daje około 10% więcej bajtów niż dwiema; tabulatory zajmują najmniej miejsca z tych trzech opcji. Żadna z nich nie wpływa na sparsowane dane.
Tryb kompaktowy (minifikacja)
Usuwa wszystkie białe znaki między tokenami i ponownie zapisuje każdy rekord w jednej linii. To odwrotność formatowania z wcięciami i jedyny tryb, którego wynik na pewno jest poprawnym JSONL. Minifikacja wcześniej sformatowanych danych zwykle zmniejsza ich rozmiar o 20–40%.
Sortowanie kluczy
Sortuje klucze obiektów alfabetycznie, również w obiektach zagnieżdżonych. Semantyka JSON pozostaje bez zmian (zgodnie z RFC 8259 kolejność kluczy nie ma znaczenia), ale uporządkowany wynik zapewnia stabilne diffy — dwa eksporty tych samych danych można porównać w git linia po linii.

Typowe zastosowania

Debugowanie odpowiedzi API
Formatuj logi API zapisane w JSONL, aby łatwiej je czytać i szybciej wykrywać problemy w danych odpowiedzi.
Przegląd kodu
Nadaj czytelny układ plikom konfiguracyjnym i zbiorom danych w JSONL, aby ułatwić przegląd kodu i porównywanie zmian w pull requestach.
Przeglądanie logów
Formatuj logi JSONL w czytelny sposób, aby śledzić działanie aplikacji i analizować błędy.
Dokumentacja danych
Formatuj przykłady JSONL do wykorzystania w dokumentacji, plikach README i poradnikach technicznych.
Walidacja konfiguracji CI/CD
Nadaj czytelny układ plikom konfiguracyjnym JSONL używanym w pipeline’ach CI/CD, aby szybko zauważyć błędy konfiguracji lub brakujące pola przed wdrożeniem.
Ujednolicanie logów serwera
Minifikuj logi serwerów w JSONL lub ujednolicaj ich format w różnych usługach na potrzeby centralnych systemów zarządzania logami.

Częste błędy i rozwiązania

Pojedyncze cudzysłowy zamiast podwójnych

W JSON ciągi znaków i klucze muszą być ujęte w podwójne cudzysłowy. Jeśli w danych JSONL używasz pojedynczych cudzysłowów (co często zdarza się przy kopiowaniu z Pythona lub JavaScriptu), parsowanie linii się nie powiedzie. Aby to naprawić, zamień wszystkie pojedyncze cudzysłowy na podwójne.

Wiele obiektów JSON w jednej linii

Każda linia pliku JSONL musi zawierać dokładnie jedną wartość JSON. Jeśli połączysz kilka obiektów w jednej linii bez rozdzielenia ich znakami nowej linii, może udać się sparsować tylko pierwszy z nich. Upewnij się, że każdy obiekt JSON znajduje się w osobnej linii.

Znaki specjalne w ciągach znaków bez sekwencji ucieczki

W ciągach znaków JSON odwrotne ukośniki, tabulatory i znaki nowej linii trzeba zapisywać jako odpowiednie sekwencje ucieczki (\\, \t, \n). Znaki sterujące zapisane bezpośrednio spowodują błędy parsowania. Sprawdź, czy ciągi znaków zawierają tabulatory lub znaki nowej linii, i zastąp je sekwencjami ucieczki.

Najczęściej zadawane pytania

Czy formatowanie zmienia moje dane?

Nie. Formatowanie zmienia jedynie białe znaki i wcięcia. Wartości, klucze i struktura Twoich danych pozostają dokładnie takie same. Opcja sortowania kluczy ustawia je w kolejności alfabetycznej, ale nie zmienia żadnych wartości.

Na czym polega tryb kompaktowy?

Tryb kompaktowy minifikuje każdą linię JSON, usuwając wszystkie zbędne białe znaki. Przydaje się to, gdy zależy Ci na jak najmniejszym rozmiarze pliku JSONL.

Czy moje dane są bezpieczne?

Tak. Całe formatowanie odbywa się lokalnie w Twojej przeglądarce. Żadne dane nie są wysyłane na serwer. Twoje dane JSONL nigdy nie opuszczają Twojego urządzenia.

Czy mogę sformatować linie zawierające nieprawidłowy JSON?

Linii z błędami nie da się sformatować, ale pozostają one bez zmian w wyniku i są zgłaszane osobno, aby łatwo było je znaleźć i poprawić.

Jak działa opcja sortowania kluczy?

Opcja sortowania kluczy porządkuje alfabetycznie wszystkie klucze w każdym obiekcie JSON, z uwzględnieniem wielkości liter. Sortowane są również klucze obiektów zagnieżdżonych. Pozwala to uzyskać spójny wynik przy porównywaniu plików JSONL i generować powtarzalne diffy.

Czy mogę używać tego narzędzia do formatowania zwykłych plików JSON?

To narzędzie jest przeznaczone do plików JSONL (jeden obiekt JSON na linię). Zadziała też z pojedynczym dokumentem JSON, jeśli cały dokument mieści się w jednej linii. W przypadku JSON rozpisanego na wiele linii użyj standardowego formatera JSON.

Czym różni się formatowanie JSONL od formatowania JSON?

Przy formatowaniu JSONL każda linia jest traktowana niezależnie, jako osobna wartość JSON. Formatowanie JSON traktuje cały plik jako jeden dokument JSON. Nasze narzędzie przetwarza każdą linię osobno, zgodnie z zasadami formatu JSONL/NDJSON.

Czy minifikacja JSONL znacznie zmniejsza rozmiar pliku?

Tak. Tryb kompaktowy może zmniejszyć rozmiar pliku o 20-50%, jeśli obiekty JSON w pliku JSONL są rozpisane z wcięciami lub zawierają dodatkowe odstępy. Oszczędność zależy od pierwotnej wielkości wcięć i głębokości zagnieżdżenia danych.

Powiązane narzędzia i przewodniki