ForHosting KIT · البيانات والملفات: تحويل وتنظيف

حوّل صفحة HTML إلى Markdown

أداة تحوّل كود HTML إلى نص Markdown مكافئ — عناوين، فقرات، قوائم، روابط — بصيغة بسيطة سهلة القراءة والتعديل، بدل وسوم HTML المتشابكة الصعبة. تفيد من ينقل محتوى من موقع قديم إلى نظام توثيق أو مستودع كود حديث بسرعة ودقة.

● مستقرةمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدالتطبيق قريبًاTelegram قريبًا

لماذا تحتاج Markdown بدل HTML الأصلي

أنظمة التوثيق الحديثة ومستودعات الكود، وأدوات كتابة كثيرة، تتعامل مع Markdown كصيغتها الأساسية، بينما محتوى موقع قديم أو صفحة مصدَّرة يصل بوسوم HTML كاملة يصعب قراءتها أو تعديلها مباشرة. نقل محتوى مثل هذا إلى نظام توثيق جديد يعني إما إعادة كتابته من الصفر، أو تنظيف وسوم HTML يدويًا سطرًا بسطر، وكلاهما عمل بطيء لا داعي له حين يمكن التحويل الآلي في ثوانٍ معدودة.

ما الذي يُحفَظ في التحويل

تُحوَّل وسوم h1 حتى h6 إلى عناوين Markdown بعلامة #، الفقرات إلى نص عادي مفصول بسطر فارغ، القوائم إلى شرطات أو أرقام، الروابط إلى صيغة نص بين قوسين مربعين ورابط بين قوسين، والنص العريض والمائل إلى نجمتين أو نجمة واحدة. الوسوم البصرية البحتة مثل تنسيق الألوان أو الخطوط تُحذف لأن Markdown لا يعبّر عنها، فيبقى المحتوى النصي والبنيوي فقط دون أي تفاصيل عرض مرتبطة بتصميم الصفحة الأصلي.

الاستخدام من الصفحة مباشرة

الصق كود HTML، شغّل الأداة، وعاين نص Markdown الناتج قبل نسخه إلى الوجهة النهائية مباشرة. المعالجة كاملة داخل متصفحك، بلا حدّ للاستخدام وبلا تسجيل، وتعمل من الحاسوب أو الجوال، مناسبة لنقل مقال أو صفحة توثيق واحدة أو عدة صفحات تباعًا يدويًا دون أي أداة خارجية أو تثبيت إضافي على الجهاز نفسه أو أي جهاز آخر تستخدمه للعمل اليومي المعتاد على مدار الأسبوع.

الأتمتة عبر الـAPI

من يرحّل موقعًا كاملًا إلى نظام توثيق جديد يحتاج تحويل عشرات أو مئات الصفحات دفعة واحدة. تتوفر الأداة عبر الـAPI: تُرسل صفحة HTML وتعود نسخة Markdown مكافئة. السعر $0.002 للطلب الواحد، فتُحوَّل كل صفحة تلقائيًا ضمن مسار ترحيل آلي بلا نسخ يدوي صفحة صفحة واحدة تلو الأخرى طوال مشروع الترحيل الكامل من البداية حتى آخر صفحة في الموقع القديم بأكمله.

حالات الاستخدام

ترحيل توثيق منتج قديم

ترحّل شركة الخليج الرقمية عشرات صفحات توثيق منتج قديمة بصيغة HTML إلى نظام توثيق جديد يعتمد Markdown، صفحة صفحة عبر الـAPI.

نقل مقال من موقع إلى مدونة جديدة

ينقل محمد الحربي مقالًا قديمًا من موقعه الأول إلى منصة تدوين جديدة تعتمد Markdown، فيحوّل الكود الأصلي بدل إعادة كتابة المقال بالكامل.

أرشفة صفحة ويب في مستودع كود

يحفظ فريق تقني في مؤسسة النخيل للمقاولات نسخة نصية من صفحة مواصفات فنية داخل مستودع الكود بصيغة Markdown سهلة المراجعة والتعديل لاحقًا.

الأسئلة الشائعة

هل يحافظ التحويل على الروابط الأصلية؟

نعم، تتحوّل الروابط إلى صيغة Markdown القياسية محافظة على النص الظاهر ووجهة الرابط كما وردت في الكود الأصلي.

هل الاستخدام من المتصفح مجاني؟

نعم بلا حدّ وبلا تسجيل؛ المدفوع فقط عبر الـAPI بسعر $0.002 للطلب الواحد.

هل يُرسل الكود لأي خادم عند الاستخدام من الصفحة؟

لا، يجري التحويل بالكامل داخل متصفحك؛ فقط عبر الـAPI ينتقل الكود لأن المعالجة تتم من طرفنا حينها.

ماذا يحدث للجداول والصور؟

تتحوّل الجداول إلى صيغة جدول Markdown، والصور إلى صيغة رابط صورة Markdown محافظة على النص البديل إن وُجد.

هل يزيل تنسيقات CSS المضمّنة؟

نعم، Markdown لا يعبّر عن تنسيق بصري كالألوان والخطوط، فتُحذف هذه التفاصيل ويبقى المحتوى النصي والبنيوي فقط.

هل يعمل مع صفحة ويب كاملة أم كود جزئي فقط؟

يعمل مع الحالتين: كود HTML جزئي أو محتوى صفحة كاملة تلصقه مباشرة.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/data/html-to-markdown

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/data/html-to-markdown \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/data/html-to-markdown", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/html-to-markdown",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/html-to-markdown", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/html-to-markdown", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "input": "…"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.html_to_markdown",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

max_mb 25

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا