# Panduan Alat JSON: Tukar Dokumen dan Data kepada JSON dan Sebaliknya

> Panduan ini menerangkan bagaimana alat JSON membaca dan menulis fail, format dokumennya, dan alat mana yang sesuai untuk setiap tugas.

- Halaman: https://acepdfmd.com/ms/guides/json-guide/
- Dikemas kini: 2026-09-21
- Berjalan di: https://acepdfmd.com (Fail yang dimuat naik dihapuskan dalam masa 60 minit. Tanpa pendaftaran untuk penggunaan ringan.)
- Juga dalam 29 bahasa: https://acepdfmd.com/<lang>/guides/json-guide/

## Mengapa JSON

JSON adalah format data yang paling mudah dibaca oleh program, perkhidmatan web dan model AI: objek dengan medan bernama, senarai, nombor, teks, true, false dan null, tiada apa-apa lagi. Dokumen dan hamparan tidak disimpan dengan cara itu. Alat dalam keluarga ini merapatkan jurang dalam kedua-dua arah: ia menukar PDF, fail Word, hamparan, CSV, YAML dan XML kepada JSON, dan ia menukar JSON kembali kepada fail yang boleh dibaca orang, seperti PDF, Word, Excel, CSV dan HTML.

Setiap alat berjalan di pelayan kami melalui sambungan selamat dan memadam fail yang dimuat naik dalam masa 60 minit. Input teks boleh ditampal terus tanpa perlu dimuat naik.

## Alat Mana untuk Tugas Mana

| Anda ada | Anda mahu | Guna |
|---|---|---|
| PDF | Teks, jadual dan metadata sebagai data | [PDF ke JSON](https://acepdfmd.com/ms/tool/pdf-to-json/) |
| Dokumen Word | Tajuk, perenggan, senarai dan jadual sebagai data | [Word ke JSON](https://acepdfmd.com/ms/tool/word-to-json/) |
| Buku kerja Excel | Rekod, baris atau lajur | [Excel ke JSON](https://acepdfmd.com/ms/tool/excel-to-json/) |
| Fail CSV atau TSV | Tatasusunan JSON dengan nilai bertaip | [CSV ke JSON](https://acepdfmd.com/ms/tool/csv-to-json/) |
| Fail YAML | Data yang sama sebagai JSON | [YAML ke JSON](https://acepdfmd.com/ms/tool/yaml-to-json/) |
| Fail XML | Objek, atribut dan tatasusunan | [XML ke JSON](https://acepdfmd.com/ms/tool/xml-to-json/) |
| JSON | PDF untuk dibaca atau dicetak | [JSON ke PDF](https://acepdfmd.com/ms/tool/json-to-pdf/) |
| JSON | Buku kerja Excel | [JSON ke Excel](https://acepdfmd.com/ms/tool/json-to-excel/) |
| JSON | Fail CSV | [JSON ke CSV](https://acepdfmd.com/ms/tool/json-to-csv/) |
| JSON | Dokumen Word yang boleh disunting | [JSON ke Word](https://acepdfmd.com/ms/tool/json-to-word/) |
| JSON | Halaman web | [JSON ke HTML](https://acepdfmd.com/ms/tool/json-to-html/) |
| JSON | YAML untuk fail konfigurasi | [JSON ke YAML](https://acepdfmd.com/ms/tool/json-to-yaml/) |
| JSON | XML untuk sistem lain | [JSON ke XML](https://acepdfmd.com/ms/tool/json-to-xml/) |
| JSON yang bercelaru atau tidak sah | JSON yang bersih dan sah | [Pemformat JSON](https://acepdfmd.com/ms/tool/json-formatter/) |
| Dua fail JSON | Senarai apa yang berubah | [Bandingkan JSON](https://acepdfmd.com/ms/tool/json-compare/) |

Markdown mempunyai pasangannya sendiri: [Markdown ke JSON](https://acepdfmd.com/ms/tool/markdown-to-json/) mengeksport pokok dokumen dan [JSON ke Markdown](https://acepdfmd.com/ms/tool/json-to-markdown/) menukar JSON kepada rangka atau jadual Markdown.

## Format Dokumen

PDF ke JSON dan Word ke JSON menulis bentuk yang sama, supaya satu kod boleh mengendalikan kedua-duanya. Tahap atas sentiasa mempunyai medan berikut:

```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": []}
}
```

Medan-medan ini bermaksud seperti berikut:

- source: apa fail itu, dengan metadata yang dibawanya (tajuk, pengarang, subjek, kata kunci, tarikh cipta dan pengubahsuaian, bilangan halaman). Fail Word menambah bilangan perkataan, jadual dan imej.
- pages: satu entri bagi setiap halaman PDF dengan saiznya dalam titik, putarannya, bilangan perkataan dan teksnya. Fail Word tidak mempunyai halaman, kerana Word hanya menyusun halaman apabila ia dicetak.
- blocks: dokumen mengikut urutan bacaan. Jenisnya adalah heading (dengan tahap 1 hingga 6), paragraph (dengan nama gaya pilihan daripada Word), list (bernombor atau tidak, item dengan tahap bersarang), table (pengepala serta baris bertaip), code, blockquote, rule dan image.
- tables: bagi PDF, setiap jadual yang dikesan dengan halaman ia ditemui dan, bagi jadual yang bersambung, halaman ia berakhir. Sel yang kelihatan seperti nombor adalah nombor.
- form_fields: hanya wujud apabila PDF mempunyai borang. Setiap medan mempunyai nama, jenis (text, choice, button atau signature) dan nilai semasanya.
- extraction: penukar mana yang berjalan, mod yang anda pilih, sama ada OCR diperlukan, dan sebarang amaran, seperti jadual yang tidak dapat dikesan.

Versi 1 format ini hanya akan menambah medan; medan sedia ada mengekalkan nama dan maknanya.

## Data Berjadual dan Bersarang

CSV dan Excel adalah rata, JSON tidak. Apabila JSON ditukar kepada CSV atau Excel, objek bersarang diratakan menjadi nama lajur bertitik dan tatasusunan menjadi nama berindeks, supaya rekod pesanan dengan objek pelanggan dan tatasusunan item menjadi lajur seperti customer.name, items[0].sku dan items[1].sku. Apabila CSV atau Excel dikembalikan kepada JSON, pengepala yang ditulis dengan cara itu dibina semula menjadi objek dan tatasusunan bersarang. Pengepala dengan titik biasa, seperti nombor versi atau singkatan, dibiarkan begitu sahaja.

Nilai ditaip semasa masuk: nombor menjadi nombor, true dan false menjadi boolean, sel kosong menjadi null, dan selainnya kekal sebagai rentetan. Tarikh yang keluar daripada Excel ditulis sebagai rentetan ISO 8601, kerana JSON tidak mempunyai jenis tarikh. Tukar pilihan jenis nilai kepada teks apabila pengenal dengan sifar pendahulu perlu kekal seperti yang ditulis.

## Pengesahan dan Pembaikan

Setiap alat JSON mengesahkan inputnya dengan cara yang sama. Fail yang tidak sah ditolak dengan baris dan lajur kesilapan pertama, dan petikan ringkas baris tersebut. [Pemformat JSON](https://acepdfmd.com/ms/tool/json-formatter/) juga boleh membaiki kesilapan yang paling biasa ditampal orang: komen, koma berlebihan, rentetan bertanda petik tunggal, kunci tanpa petikan, True, False dan None yang bertajuk besar, NaN dan Infinity, dan pagar kod di sekeliling teks. Apabila pembaikan dilakukan hasilnya memberitahu anda, supaya tiada apa-apa berubah secara senyap di sebalik tindakan anda.

## Privasi

Fail yang dimuat naik dan teks yang ditampal diproses di pelayan kami dan dipadam dalam masa 60 minit; lihat [panduan privasi](https://acepdfmd.com/ms/guides/privacy-guide/) untuk butiran lanjut. Tiada apa-apa disimpan lebih daripada masa itu dan tiada apa-apa digunakan untuk sebarang tujuan lain.

## Alat yang disebut dalam panduan ini

- [PDF ke JSON](https://acepdfmd.com/ms/tool/pdf-to-json/): Ekstrak teks, tajuk, senarai, jadual, medan borang dan metadata PDF sebagai JSON berstruktur.
- [Word ke JSON](https://acepdfmd.com/ms/tool/word-to-json/): Tukar dokumen Word kepada JSON: tajuk, perenggan, senarai dan jadual mengikut urutan bacaan.
- [Excel ke JSON](https://acepdfmd.com/ms/tool/excel-to-json/): Tukar helaian kerja Excel kepada rekod, baris atau lajur JSON dengan nombor dan tarikh sebenar.
- [CSV ke JSON](https://acepdfmd.com/ms/tool/csv-to-json/): Tukar CSV atau TSV kepada tatasusunan objek JSON, dengan nombor bertaip dan kunci bersarang.
- [YAML ke JSON](https://acepdfmd.com/ms/tool/yaml-to-json/): Tukar YAML kepada JSON yang bersih, termasuk fail berbilang dokumen.
- [XML ke JSON](https://acepdfmd.com/ms/tool/xml-to-json/): Tukar XML kepada JSON dengan atribut, elemen berulang sebagai tatasusunan dan nilai bertaip.
- [JSON ke PDF](https://acepdfmd.com/ms/tool/json-to-pdf/): Tukar JSON kepada laporan PDF yang boleh dibaca: rekod menjadi jadual, data bersarang menjadi rangka.
- [JSON ke Excel](https://acepdfmd.com/ms/tool/json-to-excel/): Tukar JSON kepada buku kerja Excel, satu helaian bagi setiap senarai rekod, kunci bersarang sebagai lajur.
- [JSON ke CSV](https://acepdfmd.com/ms/tool/json-to-csv/): Ratakan rekod JSON kepada fail CSV yang boleh dibuka dalam mana-mana hamparan.
- [JSON ke Word](https://acepdfmd.com/ms/tool/json-to-word/): Tukar JSON kepada dokumen Word yang boleh disunting dengan tajuk, senarai dan jadual.
- [JSON ke HTML](https://acepdfmd.com/ms/tool/json-to-html/): Paparkan JSON sebagai halaman HTML berdiri sendiri dengan jadual dan rangka yang boleh dicetak.
- [JSON ke YAML](https://acepdfmd.com/ms/tool/json-to-yaml/): Tukar JSON kepada YAML yang mudah dibaca dengan kunci mengikut susunan asal.
- [JSON ke XML](https://acepdfmd.com/ms/tool/json-to-xml/): Tukar JSON kepada XML yang sah dan berlekuk dengan elemen akar pilihan anda.
- [Pemformat JSON](https://acepdfmd.com/ms/tool/json-formatter/): Sahkan, cetak kemas, minifikasi, susun atau baiki JSON, dengan baris dan lajur tepat bagi sebarang ralat.
- [Bandingkan JSON](https://acepdfmd.com/ms/tool/json-compare/): Bandingkan dua fail JSON secara struktur dan senaraikan setiap nilai yang ditambah, dibuang dan diubah mengikut laluan.
- [Markdown ke JSON](https://acepdfmd.com/ms/tool/markdown-to-json/): Eksport struktur dokumen sebagai pokok sintaks JSON (pandoc AST).
- [JSON ke Markdown](https://acepdfmd.com/ms/tool/json-to-markdown/): Tukar data JSON atau pandoc AST kepada Markdown yang mudah dibaca dengan jadual.

## Lebih banyak panduan

- [Helaian Rujukan Markdown: Sintaks dengan Contoh](https://acepdfmd.com/ms/guides/markdown-cheat-sheet/)
- [Saiz dan Dimensi Halaman PDF: A4, Letter, Legal dan Lain-lain](https://acepdfmd.com/ms/guides/pdf-page-sizes/)
- [Cara Pemampatan PDF Berfungsi dan Mengapa Fail Hampir Tidak Mengecut](https://acepdfmd.com/ms/guides/pdf-compression-guide/)
- [PDF ke Markdown: Cara Ia Berfungsi dan Cara Menggunakannya untuk AI](https://acepdfmd.com/ms/guides/pdf-to-markdown-guide/)
- [OCR untuk PDF dan Imej: Bagaimana Mendapatkan Teks yang Tepat](https://acepdfmd.com/ms/guides/ocr-guide/)
- [Adakah Selamat untuk Memuat Naik PDF Dalam Talian? Panduan Privasi](https://acepdfmd.com/ms/guides/privacy-guide/)
- [Buka dan Tukar Fail Apple iWork (Pages, Numbers, Keynote) Tanpa Mac](https://acepdfmd.com/ms/guides/iwork-guide/)