# Przewodnik po narzędziach JSON: dokumenty i dane do JSON i z powrotem

> Przewodnik po tym, jak narzędzia JSON odczytują i zapisują pliki oraz którego narzędzia użyć do jakiego zadania.

- Strona: https://acepdfmd.com/pl/guides/json-guide/
- Zaktualizowano: 2026-09-21
- Działa pod adresem: https://acepdfmd.com (Przesłane pliki są usuwane w ciągu 60 minut. Bez rejestracji przy niewielkim użyciu.)
- Także w 29 językach: https://acepdfmd.com/<lang>/guides/json-guide/

## Dlaczego JSON

JSON jest formatem danych, który programy, usługi internetowe i modele AI odczytują najłatwiej: obiekty z nazwanymi polami, listy, liczby, tekst, true, false i null, nic więcej. Dokumenty i arkusze kalkulacyjne nie są przechowywane w ten sposób. Narzędzia z tej rodziny łączą te dwa światy w obu kierunkach: zamieniają pliki PDF, Word, arkusze kalkulacyjne, CSV, YAML i XML na JSON, a JSON zamieniają z powrotem na pliki, które czytają ludzie, takie jak PDF, Word, Excel, CSV i HTML.

Każde narzędzie działa na naszych serwerach przez bezpieczne połączenie i usuwa wgrany plik w ciągu 60 minut. Tekst wejściowy można wkleić bezpośrednio, bez wgrywania pliku.

## Które narzędzie do jakiego zadania

| Masz | Chcesz | Użyj |
|---|---|---|
| PDF | Tekst, tabele i metadane jako dane | [PDF do JSON](https://acepdfmd.com/pl/tool/pdf-to-json/) |
| Dokument Word | Nagłówki, paragrafy, listy i tabele jako dane | [Word do JSON](https://acepdfmd.com/pl/tool/word-to-json/) |
| Skoroszyt Excel | Rekordy, wiersze albo kolumny | [Excel do JSON](https://acepdfmd.com/pl/tool/excel-to-json/) |
| Plik CSV albo TSV | Tablicę JSON z typowanymi wartościami | [CSV do JSON](https://acepdfmd.com/pl/tool/csv-to-json/) |
| Plik YAML | Te same dane jako JSON | [YAML do JSON](https://acepdfmd.com/pl/tool/yaml-to-json/) |
| Plik XML | Obiekty, atrybuty i tablice | [XML do JSON](https://acepdfmd.com/pl/tool/xml-to-json/) |
| JSON | PDF do czytania albo wydruku | [JSON do PDF](https://acepdfmd.com/pl/tool/json-to-pdf/) |
| JSON | Skoroszyt Excel | [JSON do Excel](https://acepdfmd.com/pl/tool/json-to-excel/) |
| JSON | Plik CSV | [JSON do CSV](https://acepdfmd.com/pl/tool/json-to-csv/) |
| JSON | Edytowalny dokument Word | [JSON do Word](https://acepdfmd.com/pl/tool/json-to-word/) |
| JSON | Stronę internetową | [JSON do HTML](https://acepdfmd.com/pl/tool/json-to-html/) |
| JSON | YAML dla pliku konfiguracyjnego | [JSON do YAML](https://acepdfmd.com/pl/tool/json-to-yaml/) |
| JSON | XML dla innego systemu | [JSON do XML](https://acepdfmd.com/pl/tool/json-to-xml/) |
| JSON, który jest bałaganem albo nieprawidłowy | Czysty, prawidłowy JSON | [Formater JSON](https://acepdfmd.com/pl/tool/json-formatter/) |
| Dwa pliki JSON | Listę tego, co się zmieniło | [Porównaj JSON](https://acepdfmd.com/pl/tool/json-compare/) |

Markdown ma swoją własną parę: [Markdown do JSON](https://acepdfmd.com/pl/tool/markdown-to-json/) eksportuje drzewo dokumentu, a [JSON do Markdown](https://acepdfmd.com/pl/tool/json-to-markdown/) zamienia JSON na konspekt albo tabelę Markdown.

## Format dokumentu

PDF do JSON i Word do JSON zapisują tę samą strukturę, dzięki czemu jeden kod obsługuje oba. Poziom najwyższy zawsze ma te pola:

```json
{
  "format": "acepdfmd-document",
  "version": 1,
  "source": {"type": "pdf", "filename": "report.pdf", "title": "Q3 Report", "pages": 12},
  "pages": [{"number": 1, "width": 612, "height": 792, "words": 380, "text": "..."}],
  "blocks": [
    {"type": "heading", "level": 1, "text": "Q3 Report"},
    {"type": "paragraph", "text": "Revenue grew..."},
    {"type": "list", "ordered": false, "items": [{"level": 0, "text": "Europe"}]},
    {"type": "table", "header": ["Region", "Q3"], "rows": [["Europe", 1200.5]]}
  ],
  "tables": [{"index": 1, "page": 3, "rows": [["Region", "Q3"], ["Europe", 1200.5]]}],
  "form_fields": [{"name": "email", "type": "text", "value": "a@b.com"}],
  "extraction": {"engine": "pdf_to_markdown/layout", "mode": "structure", "ocr": false, "warnings": []}
}
```

Pola oznaczają następujące rzeczy:

- source: czym był plik, z metadanymi, które niósł (tytuł, autor, temat, słowa kluczowe, daty utworzenia i modyfikacji, liczba stron). Pliki Word dodają liczbę słów, tabel i obrazów.
- pages: jeden wpis na stronę PDF z jej rozmiarem w punktach, obrotem, liczbą słów i tekstem. Pliki Word nie mają stron, bo Word układa strony tylko podczas drukowania.
- blocks: dokument w kolejności czytania. Typy to heading (z poziomem od 1 do 6), paragraph (z opcjonalną nazwą stylu z Word), list (uporządkowana albo nie, z pozycjami mającymi poziom zagnieżdżenia), table (nagłówek plus typowane wiersze), code, blockquote, rule i image.
- tables: dla PDF, każda wykryta tabela ze stroną, na której została znaleziona, i, jeśli tabela się kontynuuje, stroną, na której się kończy. Komórki wyglądające jak liczby są liczbami.
- form_fields: obecne tylko wtedy, gdy PDF ma formularz. Każde pole ma swoją nazwę, typ (text, choice, button albo signature) i aktualną wartość.
- extraction: który konwerter zadziałał, wybrany tryb, czy potrzebny był OCR, oraz wszelkie ostrzeżenia, na przykład tabela, której nie udało się wykryć.

Wersja 1 tego formatu może tylko zyskiwać nowe pola; istniejące pola zachowują swoje nazwy i znaczenie.

## Dane tabelaryczne i zagnieżdżenie

CSV i Excel są płaskie, JSON nie jest. Kiedy JSON idzie do CSV albo Excel, zagnieżdżone obiekty są spłaszczane do nazw kolumn z kropką, a tablice do nazw indeksowanych, więc rekord zamówienia z obiektem klienta i tablicą pozycji staje się kolumnami takimi jak customer.name, items[0].sku i items[1].sku. Kiedy CSV albo Excel wraca do JSON, nagłówki zapisane w ten sposób są odbudowywane do zagnieżdżonych obiektów i tablic. Nagłówek ze zwykłą kropką, na przykład numer wersji albo skrót, jest pozostawiany bez zmian.

Wartości są typowane przy wejściu: liczby stają się liczbami, true i false wartościami logicznymi, puste komórki null, a wszystko inne zostaje ciągiem tekstowym. Daty wychodzące z Excel są zapisywane jako ciągi ISO 8601, ponieważ JSON nie ma typu daty. Przełącz opcję typów wartości na tekst, gdy identyfikatory z zerami na początku muszą zostać zapisane dokładnie tak, jak są.

## Walidacja i naprawa

Każde narzędzie JSON waliduje swoje wejście w ten sam sposób. Nieprawidłowy plik jest odrzucany z podaniem wiersza i kolumny pierwszego błędu oraz krótkiego fragmentu tej linii. [Formater JSON](https://acepdfmd.com/pl/tool/json-formatter/) może też naprawić błędy, które ludzie wklejają najczęściej: komentarze, przecinki na końcu, ciągi w apostrofach, klucze bez cytatów, wielkie litery w True, False i None, NaN i Infinity oraz ogrodzenia kodu wokół tekstu. Kiedy naprawa została zastosowana, wynik ci to mówi, więc nic nie zmienia się w tle bez twojej wiedzy.

## Prywatność

Wgrane pliki i wklejony tekst są przetwarzane na naszych serwerach i usuwane w ciągu 60 minut; szczegóły znajdziesz w [przewodniku o prywatności](https://acepdfmd.com/pl/guides/privacy-guide/). Nic nie jest przechowywane dłużej niż ten czas i nic nie jest używane do żadnego innego celu.

## Narzędzia wymienione w tym przewodniku

- [PDF do JSON](https://acepdfmd.com/pl/tool/pdf-to-json/): Wyodrębnij tekst, nagłówki, listy, tabele, pola formularzy i metadane PDF jako uporządkowany JSON.
- [Word do JSON](https://acepdfmd.com/pl/tool/word-to-json/): Zamień dokument Word na JSON: nagłówki, paragrafy, listy i tabele w kolejności czytania.
- [Excel do JSON](https://acepdfmd.com/pl/tool/excel-to-json/): Konwertuj arkusze Excel na rekordy, wiersze lub kolumny JSON z rzeczywistymi liczbami i datami.
- [CSV do JSON](https://acepdfmd.com/pl/tool/csv-to-json/): Konwertuj CSV lub TSV na tablicę obiektów JSON, z typowanymi liczbami i zagnieżdżonymi kluczami.
- [YAML do JSON](https://acepdfmd.com/pl/tool/yaml-to-json/): Konwertuj YAML na czysty JSON, łącznie z plikami wielodokumentowymi.
- [XML do JSON](https://acepdfmd.com/pl/tool/xml-to-json/): Konwertuj XML na JSON z atrybutami, powtarzającymi się elementami jako tablicami i typowanymi wartościami.
- [JSON do PDF](https://acepdfmd.com/pl/tool/json-to-pdf/): Zamień JSON w czytelny PDF: rekordy stają się tabelami, a zagnieżdżone dane konspektem.
- [JSON do Excel](https://acepdfmd.com/pl/tool/json-to-excel/): Konwertuj JSON na skoroszyt Excel, jeden arkusz na listę rekordów, zagnieżdżone klucze jako kolumny.
- [JSON do CSV](https://acepdfmd.com/pl/tool/json-to-csv/): Spłaszcz rekordy JSON do pliku CSV, który otwiera się w każdym arkuszu kalkulacyjnym.
- [JSON do Word](https://acepdfmd.com/pl/tool/json-to-word/): Konwertuj JSON na edytowalny dokument Word z nagłówkami, listami i tabelami.
- [JSON do HTML](https://acepdfmd.com/pl/tool/json-to-html/): Wyrenderuj JSON jako samodzielną stronę HTML z tabelami i konspektem do wydruku.
- [JSON do YAML](https://acepdfmd.com/pl/tool/json-to-yaml/): Konwertuj JSON na czytelny YAML z kluczami w oryginalnej kolejności.
- [JSON do XML](https://acepdfmd.com/pl/tool/json-to-xml/): Konwertuj JSON na poprawnie sformatowany, wcięty XML z wybranym przez ciebie elementem głównym.
- [Formater JSON](https://acepdfmd.com/pl/tool/json-formatter/): Waliduj, formatuj, minifikuj, sortuj lub naprawiaj JSON, z podaniem dokładnego wiersza i kolumny każdego błędu.
- [Porównaj JSON](https://acepdfmd.com/pl/tool/json-compare/): Porównaj strukturalnie dwa pliki JSON i wypisz każdą dodaną, usuniętą i zmienioną wartość według ścieżki.
- [Markdown do JSON](https://acepdfmd.com/pl/tool/markdown-to-json/): Wyeksportuj strukturę dokumentu jako drzewo składniowe JSON (pandoc AST).
- [JSON do Markdown](https://acepdfmd.com/pl/tool/json-to-markdown/): Zamień dane JSON lub pandoc AST w czytelny Markdown z tabelami.

## Więcej przewodników

- [Ściąga Markdown: składnia z przykładami](https://acepdfmd.com/pl/guides/markdown-cheat-sheet/)
- [Rozmiary i wymiary stron PDF: A4, Letter, Legal i inne](https://acepdfmd.com/pl/guides/pdf-page-sizes/)
- [Jak działa kompresja PDF i czemu niektóre pliki prawie się nie kurczą](https://acepdfmd.com/pl/guides/pdf-compression-guide/)
- [PDF do Markdown: jak to działa i jak tego używać do AI](https://acepdfmd.com/pl/guides/pdf-to-markdown-guide/)
- [OCR dla PDF i obrazów: jak uzyskać dokładny tekst](https://acepdfmd.com/pl/guides/ocr-guide/)
- [Czy bezpiecznie przesyłać PDF online? Przewodnik po prywatności](https://acepdfmd.com/pl/guides/privacy-guide/)
- [Otwieraj i konwertuj pliki iWork (Pages, Numbers, Keynote) bez Maca](https://acepdfmd.com/pl/guides/iwork-guide/)