مهرب Markdown
في Use *stars* and _underscores_ تحصل كل نجمة وكل شرطة سفلية على شرطة عكسية، مثل \*stars\*، فتظهر الكلمات كما كُتبت بدل أن تتحول إلى خط عريض أو مائل، وتُعامل علامات الاقتباس المائلة والأقواس بالطريقة نفسها. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- النص
- Use *stars* and _underscores_ with `code`
- وضع الحساب
- Encode
- النتيجة
- Use \*stars\* and \_underscores\_ with \`code\`
- الترميز
- markdown
- طول المُدخَل
- 41
- طول المُخرَج
- 47
يحوّل مهرب Markdown هذا النص العادي إلى صيغة مسبوقة بشرطة مائلة عكسية حتى تظهر الرموز الخاصة كحروف عادية بدل التأكيد أو مقاطع الشيفرة أو الروابط أو العناوين أو علامات القوائم، ويعكس نفس التعيين عندما تلصق Markdown المهرب ليعود إلى حروف عادية. تعيد الترميز كتابة النجوم والشُرط السفلية وعلامات الاقتباس الخلفية والأقواس المربعة والمستديرة والهلالية والهاشات والأنابيب والأقواس الزاوية وعلامات ترقيم CommonMark ذات الصلة، حتى يمكن لمقتطف README أو رد محادثة أو مثبت توثيق أن يجلس داخل مستند Markdown دون تنسيق عارض. يقبل فك التهريب فقط تلك الرموز الخاصة المعروفة بعد الشرطة المائلة العكسية ويفشل بوضوح عند شرطة نهائية ناقصة أو أزواج تهريب مجهولة، فلا تبقى أخطاء الكتابة صامتة في الإنتاج. المسار حتمي بالكامل: نفس النص ونفس الوضع ينتجان دائمًا نفس النتيجة، بلا استدعاءات شبكة ولا أملاح عشوائية ولا اختصارات تعتمد على التاريخ. تشمل الفحوصات الصغيرة ترميز سطر يحتوي علامات تأكيد إلى شكل شرطة-نجمة، وفك تسلسل شبيه بالرابط بأقواس مهربة إلى ترقيم حقيقي.
ما تهريب Markdown وماذا تُرجع هذه الأداة
يعامل Markdown مجموعة صغيرة من علامات ترقيم ASCII كمؤشرات بناء: النجمة والشرطة السفلية للتأكيد، وعلامة الاقتباس الخلفية للشيفرة، والأقواس المربعة والمستديرة للروابط والصور، والهاش للعناوين، والزائد والواصلة للقوائم، والأنبوب للجداول، والأقواس الزاوية للروابط التلقائية وHTML، والمدة للتشطيب في كثير من اللهجات، والشرطة المائلة العكسية نفسها كمقدّم تهريب. يسمح CommonMark والمعالجات المتوافقة بشرطة مائلة عكسية سابقة لإبطال تلك الرموز حتى يظهر الحرف حرفيًا في المخرج المعروض.
تنفّذ هذه الصفحة ذلك المجموعة على مسار encode والعكس على decode: الاستجابة هي محتوى السلسلة المحوَّل فقط، دون لف النص بهيكل مستند كامل أو تحويله إلى HTML. بخلاف محلّل Markdown كامل، لا تبني هذه الصفحة شجرة بناء مجردة ولا تحل روابط مرجعية ولا تقيّم كتلًا متداخلة؛ تجيب فقط عقد تهريب الرموز الخاصة.
أين يناسب تهريب Markdown وفكّه سير عمل المطوّر
يصادف المطوّرون تهريب Markdown عندما يدمجون عناوين المستخدمين في قوالب التذاكر، أو يكتبون يدويًا أمثلة README يجب أن تُظهر نجمات حرفية، أو ينظّفون رسائل الدردشة التي ستُعرض كـ Markdown، أو يعدّون مثبتات ذهبية يجب أن تنجو من معالج CommonMark صارم. ترمز فرق التوثيق والدعم أسماء المنتجات وأكواد الأخطاء الديناميكية قبل وضعها في حقل Markdown حتى لا يقلب شرطة سفلية أو اقتباس خلفي أو قوس واحد التأكيد المحيط أو يفتح رابطًا مكسورًا. يفك مؤلفو خطوط الأنابيب صادرات غنية بالتهريب من أنظمة التذاكر ليعمل كود التطبيق بترقيم حقيقي بدل تسلسلات شرطة-نجمة.
يولّد مهندسو الجودة أزواج encode وdecode حتمية لاختبارات العقد حتى لا يبدّل وسيط يدّعي تنظيف Markdown جدول تهريب غير قياسي بصمت بين الإصدارات. يستخدم المعلّمون الأداة نفسها عند تعليم الفرق بين مصدر Markdown ومجموعة الرموز الصغيرة التي تتحكم في العرض وقاعدة الشرطة المائلة العكسية التي تستعيد الحروف الحرفية.
حالات الاستخدام
مقاطع Markdown حرفية
هرّب العناوين وأسماء المنتجات ومقاطع المستخدم حتى لا تفعّل النجوم والشُرط السفلية والاقتباسات الخلفية والأقواس تأكيدًا أو شيفرة أو روابط في README ودردشة Markdown.
تنظيف المثبتات والصادرات
افكك رموز Markdown الخاصة المهرّبة بشرطة من صادرات التذاكر والسجلات أو الملفات الذهبية إلى Unicode بسيط لفروق مقروءة وكود التطبيق.
أزواج حتمية لـ CI
ولّد أزواج encode وdecode قابلة لإعادة الإنتاج لاختبارات الوحدة وفحوص العقد والوسيط الذي يجب أن يطابق التهريب الحرفي بأسلوب CommonMark.
الأسئلة الشائعة
أي حروف تُهرَّب عند encode؟
يسبق encode بشرطة مائلة عكسية الشرطة والاقتباس الخلفي والنجمة والشرطة السفلية والأقواس الهلالية والمربعة والمستديرة والهاش والزائد والواصلة والنقطة وعلامة التعجب والأنبوب والأقواس الزاوية والمدة. بقية الحروف تبقى كما هي.
ماذا يحدث إن كان التهريب ناقصًا أو غير قانوني؟
تُرفض الشُرط النهائية المنفردة وأزواج الشرطة التي ليست رمز Markdown معروفًا.
هل النتيجة حتمية؟
نعم. نفس النص ونفس الوضع ينتجان دائمًا نفس النتيجة بلا شبكة ولا عشوائية ولا سلوك يعتمد على التاريخ.
هل تحوّل الأداة Markdown إلى HTML؟
لا. تضيف الأداة الشرطات العكسية قبل المحارف الخاصة أو تزيلها فقط، ثم تعيد النص نفسه. فهي لا تبني صفحة ولا تحوّل شيئًا إلى HTML ولا تحل الروابط، لذا تندمج في أي نص Markdown تكتبه.
هل تتغير الحروف والأرقام والحروف المعلَّمة؟
لا. لا تحصل على الشرطة العكسية إلا المحارف الخاصة، أما الحروف والأرقام والمسافات وسائر المحارف العادية فتبقى كما هي، فيظل النص مقروءًا.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/enc/markdown-escape \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Use *stars* and _underscores_ with `code`"}'const res = await fetch("https://api.kit.forhosting.com/enc/markdown-escape", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Use *stars* and _underscores_ with `code`"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/markdown-escape",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Use *stars* and _underscores_ with `code`"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/markdown-escape", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Use *stars* and _underscores_ with `code`"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Use *stars* and _underscores_ with `code`"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/markdown-escape", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"text": "Use *stars* and _underscores_ with `code`"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.markdown_escape",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
استخدمه مجانًا في المتصفح لنظافة المحتوى وتنظيف المثبتات، أو استدعِ واجهة API بسعر $0.002 لكل طلب ناجح عندما تحتاج خطوط الأنابيب إلى تحويلات Markdown قابلة لإعادة الإنتاج في CI وخدمات الخلفية.
ما تهريب Markdown وماذا تُرجع هذه الأداة
تتضمن استجابة JSON دائمًا result للسلسلة المحوَّلة، وmode يعكس encode أو decode، وencoding ثابتًا على markdown، وinput_length مع output_length ليؤكد الاختبار الأحجام. يبلّغ encode أيضًا escapes_applied ويبلّغ decode escapes_resolved لتؤكد كم رمزا خاصًا أو تسلسل تهريب أُعيدت كتابته. لا يوجد تخطٍ صامت جزئي لتسلسل مكسور: إما أن كل زوج بشرطة هو رمز Markdown معروف أو يفشل الطلب بـ invalid_input. إن احتجت عرضًا على مستوى المستند أو تحويل HTML أو جداول GFM فاستخدم تلك النقاط المخصصة؛ تجيب هذه الصفحة فقط عقد التهريب وفكّه بمخرج مستقر يناسب المثبتات ومستهلكي API الذين يبنون أو يصلحون مقاطع Markdown يدويًا.
كيف يُقرأ text وmode وكيف تبقى النتائج قابلة لإعادة الإنتاج
يمشي encode السلسلة بوحدات رمز UTF-16 ويسبق فقط حروف مجموعة Markdown الخاصة بشرطة مائلة عكسية، تاركًا الحروف والأرقام والمسافات وUnicode العادي دون تغيير ليبقى النص المقروء مقروءًا. ولأن الشرطة المائلة العكسية نفسها خاصة وتُعاد كتابتها في نفس المرور من اليسار إلى اليمين مع النجوم والأقواس، تحصل على مرور تهريب واحد متسق وقابل للعكس بـ decode. يمسح decode التسلسلات التي تبدأ بشرطة ويقبل فقط حرفًا تاليًا من نفس المجموعة الخاصة. حقل الحمولة المفضّل هو text، مع الأسماء البديلة input وvalue وs وpayload حتى تعيد النماذج وسلاسل الاستعلام وعملاء SDK استخدام نفس العقد دون إعادة تسمية أعمدة. mode افتراضيًا encode ويقبل decode صراحة؛ تُطابق الأسماء البديلة op وdirection وaction نفس المفتاح للسكربتات التي تستخدم تلك الأسماء أصلًا، ويُقبل escape أو unescape كمرادفين. ترفع شرطة نهائية ناقصة أو شرطة يتبعها حرف غير خاص invalid_input برسالة تسمّي المشكلة. سقف الطول مئة ألف حرف يبقي ذاكرة Worker قابلة للتوقع ويغطي أجسام README ووثائق العينات ومعظم مخازن اللصق. اقرن التشغيل المجاني في المتصفح على هذه الصفحة بواجهة API المسعّرة عندما تحتاج نفس التعيين داخل خط أنابيب آلي دون إعادة تنفيذ جداول تهريب Markdown بنفسك. تُرجع المدخلات غير الصالحة invalid_input ولا تُحاسب، ما يبقي التحقق رخيصًا بينما تظل التحويلات الناجحة سعرًا ثابتًا للعنصر عند $0.002.
أين يناسب تهريب Markdown وفكّه سير عمل المطوّر
على هذه الصفحة يعمل كل شيء في متصفحك؛ عبر API تكلف كل استشارة ناجحة $0.002، ولا يُحاسب التحقق الفاشل، ولا يُخزَّن شيء بعد إعادة الاستجابة. ذلك الفصل—استكشاف تفاعلي مجاني وAPI مطابقة مدفوعة—يوافق بقية كتالوج KIT من المستوى A ويتيح الانتقال من عرض صفّي إلى خط أنابيب آلي دون تغيير النتيجة المهربة. اقرنه بتهريب سلاسل JSON أو ترميز URL النسبي عند الحاجة إلى تحويلات نص أوسع، وبغيرها من نقاط الترميز عند بناء مختبر صغير لأدوات مجانية وحتمية لـ CI والتوثيق.
أسئلة تقنية
كم يكلف مهرب Markdown؟
هو مجاني في متصفحك على هذه الصفحة. عبر API يكلف الطلب الناجح $0.002؛ والمدخلات غير الصالحة لا تُحاسب.
ما الأوضاع المدعومة؟
mode=encode (الافتراضي) يحوّل النص العادي إلى رموز Markdown خاصة مهرّبة بشرطة. mode=decode يعيد تلك التهريبات إلى حروف.