تنسيق Markdown المعتمد في نص إجابة QnA Maker

  • مقالة

يخزن QnA Maker نص الإجابة كعلامة. هناك العديد من النكهات من markdown. للتأكد من إرجاع نص الإجابة وعرضه بشكل صحيح، استخدم هذا المرجع.

استخدم البرنامج التعليمي CommonMark للتحقق من صحة Markdown. يحتوي البرنامج التعليمي على ميزة جرِّبه للتحقق من صحة النسخ/اللصق السريع.

متى تستخدم تحرير نص منسق مقابل وضع علامة على العلامات

يسمح لك تحرير النص المنسق للإجابات، كمؤلف، باستخدام شريط أدوات تنسيق لتحديد النص وتنسيقه بسرعة.

Markdown هي أداة أفضل عندما تحتاج إلى إنشاء المحتوى تلقائيا لإنشاء قواعد معارف ليتم استيرادها كجزء من البنية الأساسية لبرنامج ربط العمليات التجارية CI/CD أو لاختبار الدفعات.

تنسيق markdown المعتمد

فيما يلي قائمة بتنسيقات markdown التي يمكنك استخدامها في نص إجابة QnA Maker.

الغرض Format مثال على markdown استدعاء
كما هو معروض في الدردشة الآلية
سطر جديد بين جملتين. \n\n How can I create a bot with \n\n QnA Maker? format new line between two sentences
العناوين من h1 إلى h6، عدد # العناوين التي تشير إلى العنوان. 1 # هو h1. \n# text \n## text \n### text \n####text \n#####text ## Creating a bot \n ...text.... \n### Important news\n ...text... \n### Related Information\n ....text...

\n# my h1 \n## my h2\n### my h3 \n#### my h4 \n##### my h5		 format with markdown headers
format with markdown headers H1 to H5
مائل *text* How do I create a bot with *QnA Maker*? format with italics
قوي (بالخط العريض) **text** How do I create a bot with **QnA Maker**? format with strong marking for bold
URL للارتباط [text](https://www.my.com) How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? format for URL (hyperlink)
*URL للصورة العامة ![text](https://www.my.com/image.png) How can I create a bot with ![QnAMaker](https://review.learn.microsoft.com/azure/ai-services/qnamaker/media/qnamaker-how-to-key-management/qnamaker-resource-list.png) format for public image URL
يتوسطه خط ~~text~~ some ~~questoins~~ questions need to be asked format for strikethrough
غامق ومائل ***text*** How can I create a ***QnA Maker*** bot? format for bold and italics
URL خط عريض للارتباط [**text**](https://www.my.com) How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? format for bold URL
عنوان URL المائل للارتباط [*text*](https://www.my.com) How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? format for italics URL
إلغاء رموز markdown \*text\* How do I create a bot with \*QnA Maker\*? Format for escape markdown symbols.
قائمة مرتبة \n 1. item1 \n 1. item2 This is an ordered list: \n 1. List item 1 \n 1. List item 2
يستخدم المثال السابق الترقيم التلقائي المضمن في markdown.
This is an ordered list: \n 1. List item 1 \n 2. List item 2
يستخدم المثال السابق ترقيمًا صريحًا.		 format for ordered list
قائمة غير مرتبة \n * item1 \n * item2
أو
\n - item1 \n - item2		 This is an unordered list: \n * List item 1 \n * List item 2 format for unordered list
القوائم المتداخلة \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2

\n * Parent1 \n\t 1. Child1 \n\t * Child2 \n 1. Parent2

يمكنك تداخل القوائم المرتبة وغير المرتبة معا. تشير علامة التبويب \t إلى مستوى المسافة البادئة للعنصر التابع.		 This is an unordered list: \n * List item 1 \n\t * Child1 \n\t * Child2 \n * List item 2

This is an ordered nested list: \n 1. Parent1 \n\t 1. Child1 \n\t 1. Child2 \n 1. Parent2		 format for nested unordered list
format for nested ordered list

*QnA Maker لا يعالج الصورة بأي شكل من الأشكال. دور تطبيق العميل هو عرض الصورة.

إذا كنت ترغب في إضافة محتوى باستخدام التحديث/استبدال واجهات برمجة التطبيقات قاعدة معارف ويحتوي المحتوى/الملف على علامات html، يمكنك الاحتفاظ بـ HTML في ملفك عن طريق التأكد من تحويل فتح العلامات وإغلاقها بالتنسيق المشفرة.

الاحتفاظ بـ HTML التمثيل في طلب واجهة برمجة التطبيقات التمثيل في قاعدة المعارف
‏‏نعم‬ < > <br>
‏‏نعم‬ < h3> العنوان&/h3> <h3>العنوان</h3>

بالإضافة إلى ذلك، يتم تحويل CR LF (\r\n) إلى \n في قاعدة المعارف. يتم الاحتفاظ بـ LF (\n) كما هو. إذا كنت تريد الهروب من أي تسلسل إلغاء مثل \t أو \n يمكنك استخدام شرطة مائلة عكسية، على سبيل المثال: '\\r\\n' و'\\t'

الخطوات التالية

راجع تنسيقات ملفات اختبار الدفعات.