# دليل أدوات JSON: تحويل المستندات والبيانات إلى JSON والعودة منه

> يشرح هذا الدليل كيف تقرأ أدوات JSON الملفات وتكتبها، وصيغة المستند التي تُنتجها أداتا PDF إلى JSON وWord إلى JSON، وأي أداة تستخدم لكل مهمة.

- الصفحة: https://acepdfmd.com/ar/guides/json-guide/
- آخر تحديث: 2026-09-21
- يعمل على: https://acepdfmd.com (تُحذف الملفات المرفوعة خلال 60 دقيقة. لا حاجة للتسجيل للاستخدام الخفيف.)
- متوفر أيضًا بـ 29 لغة: https://acepdfmd.com/<lang>/guides/json-guide/

## لماذا JSON

JSON هو صيغة البيانات التي تقرؤها البرامج وخدمات الويب ونماذج الذكاء الاصطناعي بأسهل طريقة: كائنات بحقول مسمّاة، وقوائم، وأرقام، ونص، وtrue وfalse وnull، ولا شيء آخر. لا تُخزَّن المستندات وجداول البيانات بهذا الشكل. تسدّ هذه الأدوات الفجوة في كلا الاتجاهين: تحوّل ملفات PDF وWord وجداول البيانات وCSV وYAML وXML إلى JSON، وتحوّل JSON مرة أخرى إلى ملفات يقرؤها الناس، مثل PDF وWord وExcel وCSV وHTML.

تعمل كل أداة على خوادمنا عبر اتصال آمن وتحذف الملف المرفوع خلال 60 دقيقة. يمكن لصق النص المُدخَل مباشرة بدلًا من رفعه.

## أي أداة لأي مهمة

| لديك | تريد | استخدم |
|---|---|---|
| ملف PDF | نص وجداول وبيانات وصفية كبيانات | [PDF إلى JSON](https://acepdfmd.com/ar/tool/pdf-to-json/) |
| مستند Word | عناوين وفقرات وقوائم وجداول كبيانات | [Word إلى JSON](https://acepdfmd.com/ar/tool/word-to-json/) |
| مصنّف Excel | سجلات أو صفوف أو أعمدة | [Excel إلى JSON](https://acepdfmd.com/ar/tool/excel-to-json/) |
| ملف CSV أو TSV | مصفوفة JSON بقيم مصنّفة | [CSV إلى JSON](https://acepdfmd.com/ar/tool/csv-to-json/) |
| ملف YAML | نفس البيانات كـJSON | [YAML إلى JSON](https://acepdfmd.com/ar/tool/yaml-to-json/) |
| ملف XML | كائنات وسمات ومصفوفات | [XML إلى JSON](https://acepdfmd.com/ar/tool/xml-to-json/) |
| JSON | ملف PDF للقراءة أو الطباعة | [JSON إلى PDF](https://acepdfmd.com/ar/tool/json-to-pdf/) |
| JSON | مصنّف Excel | [JSON إلى Excel](https://acepdfmd.com/ar/tool/json-to-excel/) |
| JSON | ملف CSV | [JSON إلى CSV](https://acepdfmd.com/ar/tool/json-to-csv/) |
| JSON | مستند Word قابل للتحرير | [JSON إلى Word](https://acepdfmd.com/ar/tool/json-to-word/) |
| JSON | صفحة ويب | [JSON إلى HTML](https://acepdfmd.com/ar/tool/json-to-html/) |
| JSON | YAML لملف إعداد | [JSON إلى YAML](https://acepdfmd.com/ar/tool/json-to-yaml/) |
| JSON | XML لنظام آخر | [JSON إلى XML](https://acepdfmd.com/ar/tool/json-to-xml/) |
| JSON غير منظّم أو غير صالح | JSON نظيف وصالح | [منسّق JSON](https://acepdfmd.com/ar/tool/json-formatter/) |
| ملفا JSON | قائمة بما تغيّر | [مقارنة JSON](https://acepdfmd.com/ar/tool/json-compare/) |

لـMarkdown زوج خاص به: [Markdown إلى JSON](https://acepdfmd.com/ar/tool/markdown-to-json/) يصدّر شجرة مستند و[JSON إلى Markdown](https://acepdfmd.com/ar/tool/json-to-markdown/) يحوّل JSON إلى مخطط تفصيلي أو جدول من Markdown.

## صيغة المستند

تكتب أداتا PDF إلى JSON وWord إلى JSON الشكل نفسه، بحيث تتعامل معه شيفرة واحدة. يحتوي المستوى الأعلى دائمًا على هذه الحقول:

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

تعني الحقول ما يلي:

- source: نوع الملف، مع البيانات الوصفية التي حملها (العنوان، المؤلف، الموضوع، الكلمات المفتاحية، تاريخا الإنشاء والتعديل، عدد الصفحات). تضيف ملفات Word عدد الكلمات والجداول والصور.
- pages: مُدخَل واحد لكل صفحة PDF بحجمها بالنقاط، ودورانها، وعدد كلماتها، ونصها. ملفات Word لا تحتوي على صفحات، لأن Word يوزّع الصفحات فقط عند الطباعة.
- blocks: المستند بترتيب القراءة. الأنواع هي heading (بمستوى من 1 إلى 6)، وparagraph (باسم نمط اختياري من Word)، وlist (مرتبة أو غير مرتبة، بعناصر ذات مستوى تداخل)، وtable (ترويسة وصفوف مصنّفة)، وcode، وblockquote، وrule، وimage.
- tables: لملفات PDF، كل جدول تم اكتشافه مع الصفحة التي وُجد فيها، وللجدول الذي يمتد، الصفحة التي ينتهي عندها. الخلايا التي تبدو أرقامًا هي أرقام.
- form_fields: موجود فقط عندما يحتوي PDF على نموذج. لكل حقل اسمه ونوعه (نص، اختيار، زر أو توقيع) وقيمته الحالية.
- extraction: أي محوِّل عمل، والوضع الذي اخترته، وهل احتاج الأمر إلى OCR، وأي تحذيرات، مثل جدول لم يمكن اكتشافه.

الإصدار 1 من هذه الصيغة يكتسب حقولًا جديدة فقط؛ تحتفظ الحقول الحالية بأسمائها ومعانيها.

## البيانات الجدولية والتداخل

CSV وExcel مسطّحان، وJSON ليس كذلك. عندما يذهب JSON إلى CSV أو Excel، تُسطَّح الكائنات المتداخلة إلى أسماء أعمدة منقوطة والمصفوفات إلى أعمدة مرقّمة، بحيث يصبح سجل طلب فيه كائن عميل ومصفوفة عناصر أعمدة مثل customer.name وitems[0].sku وitems[1].sku. وعندما يعود CSV أو Excel إلى JSON، تُعاد بناء الترويسات المكتوبة بهذا الشكل إلى كائنات ومصفوفات متداخلة. الترويسة التي تحتوي على نقطة عادية، مثل رقم إصدار أو اختصار، تُترَك كما هي.

تُصنَّف القيم عند الدخول: تتحول الأرقام إلى أرقام، وtrue وfalse إلى قيم منطقية، والخلية الفارغة إلى null، وكل شيء آخر يبقى نصًا. تُكتَب التواريخ الخارجة من Excel كنصوص بصيغة ISO 8601، لأن JSON لا يملك نوع تاريخ. بدّل خيار أنواع القيم إلى نص عندما يجب أن تبقى المعرِّفات ذات الأصفار البادئة كما كُتبت بالضبط.

## التحقق من الصحة والإصلاح

تتحقق كل أداة JSON من صحة مدخلها بالطريقة نفسها. يُرفَض الملف غير الصالح مع سطر وعمود أول خطأ، ومقتطف قصير من ذلك السطر. يمكن أيضًا لـ[منسّق JSON](https://acepdfmd.com/ar/tool/json-formatter/) إصلاح الأخطاء التي يلصقها الناس غالبًا: التعليقات، والفواصل الزائدة، والنصوص بعلامات اقتباس مفردة، والمفاتيح غير المقتبسة، وTrue وFalse وNone بأحرف كبيرة، وNaN وInfinity، وأسوار الشيفرة حول النص. عند تطبيق إصلاح، تخبرك النتيجة بذلك، حتى لا يتغيّر شيء بصمت من دون علمك.

## الخصوصية

تُعالَج الملفات المرفوعة والنصوص الملصقة على خوادمنا وتُحذَف خلال 60 دقيقة؛ راجع [دليل الخصوصية](https://acepdfmd.com/ar/guides/privacy-guide/) للتفاصيل. لا يُخزَّن شيء بعد ذلك الوقت ولا يُستخدَم لأي غرض آخر.

## الأدوات المذكورة في هذا الدليل

- [PDF إلى JSON](https://acepdfmd.com/ar/tool/pdf-to-json/): استخراج نص ملف PDF وعناوينه وقوائمه وجداوله وحقول النماذج والبيانات الوصفية بصيغة JSON منظمة.
- [Word إلى JSON](https://acepdfmd.com/ar/tool/word-to-json/): تحويل مستند Word إلى JSON: العناوين والفقرات والقوائم والجداول بترتيب القراءة.
- [Excel إلى JSON](https://acepdfmd.com/ar/tool/excel-to-json/): تحويل أوراق عمل Excel إلى سجلات أو صفوف أو أعمدة JSON بأرقام وتواريخ حقيقية.
- [CSV إلى JSON](https://acepdfmd.com/ar/tool/csv-to-json/): تحويل CSV أو TSV إلى مصفوفة JSON من الكائنات، بأرقام مصنّفة ومفاتيح متداخلة.
- [YAML إلى JSON](https://acepdfmd.com/ar/tool/yaml-to-json/): تحويل YAML إلى JSON نظيف، بما في ذلك الملفات متعددة المستندات.
- [XML إلى JSON](https://acepdfmd.com/ar/tool/xml-to-json/): تحويل XML إلى JSON مع السمات والعناصر المتكررة كمصفوفات وقيم مصنّفة.
- [JSON إلى PDF](https://acepdfmd.com/ar/tool/json-to-pdf/): تحويل JSON إلى ملف PDF مقروء: تتحول السجلات إلى جداول، والبيانات المتداخلة إلى مخطط تفصيلي.
- [JSON إلى Excel](https://acepdfmd.com/ar/tool/json-to-excel/): تحويل JSON إلى ملف Excel، بورقة عمل واحدة لكل قائمة سجلات، والمفاتيح المتداخلة كأعمدة.
- [JSON إلى CSV](https://acepdfmd.com/ar/tool/json-to-csv/): تسطيح سجلات JSON إلى ملف CSV يُفتح في أي برنامج جداول بيانات.
- [JSON إلى Word](https://acepdfmd.com/ar/tool/json-to-word/): تحويل JSON إلى مستند Word قابل للتحرير بعناوين وقوائم وجداول.
- [JSON إلى HTML](https://acepdfmd.com/ar/tool/json-to-html/): عرض JSON كصفحة HTML مستقلة بجداول ومخطط تفصيلي قابل للطباعة.
- [JSON إلى YAML](https://acepdfmd.com/ar/tool/json-to-yaml/): تحويل JSON إلى YAML مقروء مع الحفاظ على ترتيب المفاتيح الأصلي.
- [JSON إلى XML](https://acepdfmd.com/ar/tool/json-to-xml/): تحويل JSON إلى XML صحيح البنية ومنسق بمسافات بادئة، بعنصر جذر تختاره.
- [منسّق JSON](https://acepdfmd.com/ar/tool/json-formatter/): التحقق من صحة JSON وتنسيقه أو تصغيره أو ترتيبه أو إصلاحه، مع تحديد السطر والعمود الدقيقين لأي خطأ.
- [مقارنة JSON](https://acepdfmd.com/ar/tool/json-compare/): مقارنة ملفي JSON بنيويًا وسرد كل قيمة تمت إضافتها أو حذفها أو تغييرها حسب المسار.
- [Markdown إلى JSON](https://acepdfmd.com/ar/tool/markdown-to-json/): صدّر بنية المستند كشجرة تركيب JSON (pandoc AST).
- [JSON إلى Markdown](https://acepdfmd.com/ar/tool/json-to-markdown/): حوّل بيانات JSON أو pandoc AST إلى Markdown مقروء مع جداول.

## أدلة أخرى

- [ورقة مرجعية لـ Markdown: مرجع الصياغة مع أمثلة](https://acepdfmd.com/ar/guides/markdown-cheat-sheet/)
- [أحجام وأبعاد صفحات PDF: A4 و Letter و Legal والمزيد](https://acepdfmd.com/ar/guides/pdf-page-sizes/)
- [كيف يعمل ضغط PDF ولماذا لا تتقلص بعض الملفات إلا قليلًا](https://acepdfmd.com/ar/guides/pdf-compression-guide/)
- [من PDF إلى Markdown: كيف يعمل وكيف تستخدمه للذكاء الاصطناعي](https://acepdfmd.com/ar/guides/pdf-to-markdown-guide/)
- [التعرف الضوئي على الحروف لملفات PDF والصور: كيف تحصل على نص دقيق](https://acepdfmd.com/ar/guides/ocr-guide/)
- [هل من الآمن رفع ملف PDF عبر الإنترنت؟ دليل الخصوصية](https://acepdfmd.com/ar/guides/privacy-guide/)
- [فتح وتحويل ملفات Apple iWork (Pages وNumbers وKeynote) بدون جهاز Mac](https://acepdfmd.com/ar/guides/iwork-guide/)