ماذا يعني Markdown؟ كيفية استخدام Markdown syntax / علامات التنسيق؟

تخفيض السعرماذا يعني؟

كيفية استخدام Markdown syntax / علامات التنسيق؟

نظرة عامة

Markdown هي لغة ترميز خفيفة الوزن تم إنشاؤها بواسطة John Gruber.

يسمح للأشخاص "بكتابة المستندات بتنسيق نص عادي يسهل قراءته وكتابته ، ثم تحويلها إلى مستندات XHTML (أو HTML) صالحة".

لقد استوعبت اللغة العديد من ميزات ترميز النص العادي الموجودة بالفعل في البريد الإلكتروني.

أنشأ John Gruber لغة Markdown في عام 2004 ، بالتعاون مع Aaron Swartz في جزء كبير منه على النحو.الغرض من اللغة هو استخدام "تنسيق نص عادي يسهل قراءته وكتابته ويمكن تحويله اختياريًا إلى XHTML (أو HTML) صالح".

غرض

الهدف من Markdown هو أن يكون "سهل القراءة وسهل الكتابة".

المقروئية ، افعلها على أي حال网络 营销، تجربة المستخدم مهمة جدًا.

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

يتأثر بناء جملة Markdown ببعض تنسيقات النص إلى HTML الحالية ، بما في ذلك Setext و atx و Textile و reStructuredText و Grutatext و EtText ، ولكن أكبر مصدر للإلهام هو تنسيق البريد الإلكتروني بالنص العادي.

باختصار ، يتكون بناء جملة Markdown من رموز تم اختيارها بعناية وتكون وظائفها واضحة في لمحة.على سبيل المثال: ضع العلامات النجمية حول النص لجعله يبدو مثل * التركيز *.

تبدو القوائم في Markdown مثل القوائم. تبدو اقتباسات Blockquotes في Markdown وكأنها اقتباس من نص ، تمامًا كما رأيته في رسائل البريد الإلكتروني.

متوافق مع HTML

الهدف من قواعد Markdown هو أن تكون لغة كتابة للويب.

لا يُقصد من Markdown أن يحل محل HTML ، أو حتى الاقتراب منه ، فهو يحتوي على أنواع قليلة جدًا من بناء الجملة ويتوافق فقط مع مجموعة فرعية صغيرة من ترميز HTML. لم يتم تصميم Markdown لتسهيل كتابة مستندات HTML.

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

يمكن كتابة العلامات التي لا يغطيها Markdown بتنسيق HTML مباشرةً في المستندترويج الويبينسخ.ليست هناك حاجة لتمييز هذا كـ HTML أو Markdown ؛ فقط أضف الترميز مباشرة.

يتم تقييد بعض عناصر كتلة HTML فقط - مثل <div>،<table>،<pre>،<p> وغيرها من العلامات ، يجب فصلها عن مناطق المحتوى الأخرى مع وجود أسطر فارغة قبلها وبعدها ، ولا يمكن وضع مسافة بادئة بين علامات الفتح والإغلاق بعلامات جدولة أو مسافات. يعد منشئ Markdown ذكيًا بما يكفي لعدم إضافة علامات كتلة HTML غير ضرورية <p> ضع الكلمة المناسبة.

المثال على النحو التالي ، إضافة جدول HTML إلى ملف Markdown:

这是一个普通段落。

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

这是另一个普通段落。

لاحظ أنه لن تتم معالجة بنية تنسيق Markdown بين علامات كتلة HTML.على سبيل المثال ، إذا كنت تستخدم نمط Markdown داخل كتلة HTML*强调*لن يكون لها أي تأثير.

علامات قسم HTML (مضمنة) مثل <span>،<cite>،<del> يمكن استخدامها بحرية في فقرات Markdown أو القوائم أو العناوين.وفقًا للعادات الشخصية ، يمكنك حتى استخدام علامات HTML للتنسيق دون استخدام تنسيق Markdown.مثال: إذا كنت تفضل HTML <a> 或 <img> العلامات ، والتي يمكن استخدامها مباشرة بدون الرابط أو صيغة علامة الصورة التي يوفرها Markdown.

على عكس علامات كتلة HTML ، فإن صيغة Markdown صالحة بين علامات قسم HTML.

التحويل التلقائي للأحرف الخاصة

في ملفات HTML ، هناك حرفان يتطلبان معالجة خاصة: < و & . < تستخدم الرموز لعلامات البدء ،& تُستخدم الرموز لتمييز كيانات HTML ، إذا كنت تريد فقط عرض النموذج الأولي لهذه الأحرف ، فعليك استخدام نموذج الكيان ، مثل < و &.

& تتسبب الأحرف بشكل خاص في تعذيب كتّاب مستندات الويب ، إذا كنت ستكتب "AT&T"، يجب أن تكتب"AT&T".بينما في URL & يتم أيضًا تحويل الأحرف.على سبيل المثال تريد الارتباط بـ:

http://images.google.com/images?num=30&q=larry+bird

يجب عليك كتابة تحويل URL على النحو التالي:

http://images.google.com/images?num=30&q=larry+bird

ليتم وضعها في علامة الارتباط href في الخصائص.وغني عن القول ، من السهل تجاهل هذا ، وربما يكون أكبر عدد من الأخطاء التي تم اكتشافها بواسطة التحقق من صحة معايير HTML.

يسمح لك Markdown بكتابة الأحرف بشكل طبيعي ، وهو يعتني بما يجب تحويله.كما ترى & يعد الحرف جزءًا من كيان حرف HTML ، ويتم تركه كما هو ، وإلا يتم تحويله إلى &؛.

لذلك إذا كنت تريد إدراج رمز حقوق النشر في المستند ©، يمكنك كتابة:

©

تخفيض السعر سيتركه كما هو.وإذا كتبت:

AT&T

سوف يقوم Markdown بتحويله إلى:

AT&T

يحدث موقف مماثل أيضًا في < تدوين ، لأن Markdown يسمح بتوافق HTML ، إذا وضعت < تُستخدم الرموز كمحددات لعلامات HTML ، ولن يقوم Markdown بإجراء أي تحويلات عليها ، ولكن إذا كتبت:

4 < 5

سوف يقوم Markdown بتحويله إلى:

4 < 5

ومع ذلك ، تجدر الإشارة إلى أنه في نطاق التعليمات البرمجية ، سواء كانت مضمنة أو كتلة ، < و & كلا الرمزينمؤكديتم تحويلها إلى كيانات HTML ، وهي ميزة تتيح لك كتابة تعليمات HTML البرمجية بسهولة في Markdown (على عكس HTML ، حيث تضع كل < و & يتم تحويل جميعها إلى كيانات HTML ، من أجل كتابة كود HTML في ملف HTML. )

عنصر كتلة

الفقرات وفواصل الأسطر

تتكون فقرة Markdown من سطر أو أكثر من سطور النص المتتالية ، مسبوقة ومتبوعة بأكثر من سطر فارغ (تعريف السطر الفارغ هو أنه يبدو فارغًا على الشاشة ويعتبر سطرًا فارغًا. على سبيل المثال ، ، إذا كان السطر يحتوي على مسافات وعلامات تبويب فقط ، فسيتم أيضًا التعامل مع السطر كسطر فارغ).يجب عدم وضع مسافة بادئة بين الفقرات العادية بمسافات أو علامات جدولة.

العبارة "تتكون من سطر واحد أو أكثر من سطور النص المتتالية" تعني في الواقع أن Markdown يسمح بأسطر جديدة إجبارية (إدراج أسطر جديدة) داخل الفقرات ، وهي ميزة تختلف عن معظم تنسيقات النص إلى HTML الأخرى (بما في ذلك النوع المتحرك "تحويل فواصل الأسطر ") ، فستقوم التنسيقات الأخرى بتحويل كل فاصل أسطر إلى <br /> ضع الكلمة المناسبة.

اذا انتفي الواقعتريد الاعتماد على Markdown لإدراجها <br /> للتسميات ، اضغط على مسافتين أو أكثر في مكان الإدراج ثم اضغط على Enter.

في الواقع ، يستغرق إنشاء المزيد من العمل (مساحات إضافية) <br /> ، ولكن ببساطة "يتم تحويل كل سطر جديد إلى <br />"الطريقة غير مناسبة في Markdown ، em في Markdownaiلا تعد علامات الاقتباس ذات النمط L والقوائم متعددة الفقرات أكثر فائدة فحسب ، بل يسهل قراءتها أيضًا عند التنضيد باستخدام فواصل الأسطر.

标题

Markdown يدعم تركيبين للعناوين ، Setext-like و atx-like.

النموذج الشبيه بـ Settext هو النموذج الذي يحتوي على الخلاصة ، باستخدام = (أعلى لقب) و - (عناوين المرتبة الثانية) ، على سبيل المثال:

This is an H1
=============

This is an H2
-------------

أي كمية = و - يمكن أن تكون فعالة.

يُدرج النموذج الذي يشبه Atx من 1 إلى 6 في بداية السطر # ، المقابلة للعناوين من 1 إلى 6 ، على سبيل المثال:

# 这是 H1

## 这是 H2

###### 这是 H6

يمكنك اختياريًا "إغلاق" الرؤوس الشبيهة بـ atx ، وهذا مخصص فقط للجماليات ، إذا كنت تشعر بالراحة بهذه الطريقة ، يمكنك إضافتها في نهاية السطر #، بينما نهايات السطر # لا يجب أن يكون الرقم هو نفسه البداية (يحدد عدد أحرف الجنيه في بداية السطر ترتيب العنوان):

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

Blockquotes Blockquotes

يتم استخدام علامات تمييز العلامات المحظورة بشكل مشابه لتلك المستخدمة في البريد الإلكتروني > من الاقتباسات.إذا كنت معتادًا على الاقتباسات في رسائل البريد الإلكتروني ، فأنت تعرف كيفية إنشاء اقتباس جماعي في ملف Markdown ، والذي سيبدو كما لو كنت تفصل الأسطر بنفسك ، ثم أضف > :

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> 
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.

يتيح لك Markdown أيضًا أن تكون كسولًا وأن تضيف فقط السطر الأول من الفقرة بأكملها > :

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

يمكن دمج مراجع الكتلة (على سبيل المثال: المراجع داخل المراجع) عن طريق إضافة عدد مختلف من > :

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

يمكن أيضًا استخدام صيغ Markdown الأخرى داخل الكتل المقتبسة ، بما في ذلك العناوين والقوائم ومجموعات التعليمات البرمجية وما إلى ذلك:

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码：
> 
>     return shell_exec("echo $input | $markdown_script");

يمكن لأي محرر نصوص لائق إنشاء اقتباسات بنمط البريد الإلكتروني بسهولة.على سبيل المثال في BBEdit يمكنك تحديد النص ثم الاختيار من القائمةزيادة التسلسل الهرمي للاقتباسات.

قائمة

تخفيض السعر 支持 有序 列表 和 无序 列表。

تستخدم القوائم غير المرتبة العلامات النجمية أو علامات الجمع أو علامات الطرح كعلامات قائمة:

*   Red
*   Green
*   Blue

أي ما يعادل:

+   Red
+   Green
+   Blue

مكافئ أيضًا لـ:

-   Red
-   Green
-   Blue

تستخدم القوائم المرتبة أرقامًا متبوعة بنقطة:

1.  Bird
2.  McHale
3.  Parish

من المهم ملاحظة أن الأرقام التي تستخدمها في علامة القائمة لا تؤثر على HTML الناتج. سيكون ترميز HTML الناتج للقائمة أعلاه هو:

<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>

إذا كان ترميز قائمتك مكتوبًا على النحو التالي:

1.  Bird
1.  McHale
1.  Parish

او حتى:

3. Bird
1. McHale
8. Parish

سيحصل كلاكما على نفس إخراج HTML بالضبط.النقطة المهمة هي أنه يمكنك جعل أرقام القائمة في ملف Markdown مماثلة لنتائج الإخراج ، أو إذا كنت كسولًا ، فلن تحتاج إلى الاهتمام بصحة الأرقام على الإطلاق.

إذا كنت تستخدم الكتابة البطيئة ، فمن المستحسن أن تبدأ بالرقم 1. للعنصر الأول ، لأن Markdown قد يدعم سمة البداية للقوائم المرتبة في المستقبل.

عادةً ما يتم وضع علامة عنصر القائمة في أقصى اليسار ، ولكن يمكن وضع مسافة بادئة لها ، حتى 3 مسافات ، ويجب أن تتبع علامة العنصر بمسافة أو علامة تبويب واحدة على الأقل.

لجعل القائمة تبدو أجمل ، يمكنك تنظيم المحتويات بمسافة بادئة ثابتة:

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
    viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
    Suspendisse id sem consectetuer libero luctus adipiscing.

ولكن إذا كنت كسولًا ، فلا بأس بذلك أيضًا:

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.

إذا كانت عناصر القائمة مفصولة بأسطر فارغة ، فسيستخدم Markdown محتوى العنصر عند إخراج HTML. <p> يتم تغليف الملصقات ، على سبيل المثال:

*   Bird
*   Magic

سيتم تحويله إلى:

<ul>
<li>Bird</li>
<li>Magic</li>
</ul>

لكن هذا:

*   Bird

*   Magic

سيتم تحويله إلى:

<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>

يمكن أن تحتوي عناصر القائمة على فقرات متعددة ، ويجب وضع مسافة بادئة للفقرات الموجودة أسفل كل عنصر بـ 4 مسافات أو علامة تبويب واحدة:

1.  This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

2.  Suspendisse id sem consectetuer libero luctus adipiscing.

يبدو أفضل كثيرًا إذا قمت بتأخير كل سطر ، بالطبع ، مرة أخرى ، إذا كنت كسولًا ، فإن Markdown يسمح أيضًا بما يلي:

*   This is a list item with two paragraphs.

    This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.

*   Another item in the same list.

إذا كنت تريد وضع مرجع داخل عنصر قائمة ، فحينئذٍ > يجب أن تكون مسافة بادئة:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

إذا كنت تريد وضع كتلة رمز ، فيجب وضع مسافة بادئة للكتلةمرتين، وهي عبارة عن 8 مسافات أو علامتي تبويب:

*   一列表项包含一个列表区块：

        <代码写在这>

بالطبع ، يمكن إنشاء قائمة بالعناصر عن طريق الخطأ ، شيء من هذا القبيل:

1986. What a great season.

بمعنى آخر ، يظهر في بداية السطررقم فترة فارغةلتجنب ذلك ، يمكنك إضافة شرطة مائلة للخلف قبل الفترة.

1986\. What a great season.

代码 区块

عادةً ما تحتوي شفرة مصدر لغة العلامات أو الكتابة ذات الصلة بالبرنامج بالفعل على كتل تعليمات برمجية منضدة. وفي العادة ، لا نريد أن يتم ضبط هذه الكتل في طريقة ملفات الفقرات العامة ، ولكننا نعرضها كما هي. سيستخدم Markdown <pre> و <code> العلامات لالتفاف كتل التعليمات البرمجية.

تعتبر الكتل البرمجية الإنشائية في Markdown بسيطة مثل وضع مسافة بادئة لـ 4 مسافات أو علامة تبويب واحدة ، على سبيل المثال ، أدخل ما يلي:

这是一个普通段落：

    这是一个代码区块。

سوف يتحول Markdown إلى:

<p>这是一个普通段落：</p>

<pre><code>这是一个代码区块。
</code></pre>

تتم إزالة المسافة البادئة من الدرجة الأولى لكل سطر (4 مسافات أو علامة تبويب واحدة) ، على سبيل المثال:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

سيتم تحويله إلى:

<p>Here is an example of AppleScript:</p>

<pre><code>tell application "Foo"
    beep
end tell
</code></pre>

تستمر كتلة التعليمات البرمجية حتى السطر غير المُسبق (أو نهاية الملف).

داخل كتلة التعليمات البرمجية ، & ، < و > سيتم تحويله تلقائيًا إلى كيانات HTML. تسهل هذه الطريقة عليك استخدام Markdown لإدخال شفرة مصدر HTML على سبيل المثال ، فقط انسخها والصقها ، وأضف مسافة بادئة ، وسيقوم Markdown الباقي بمعالجتها نيابة عنك ، مثال:

    <div class="footer">
        © 2004 Foo Corporation
    </div>

سيتم تحويله إلى:

<pre><code><div class="footer">
    © 2004 Foo Corporation
</div>
</code></pre>

في كتلة التعليمات البرمجية ، لن يتم تحويل بناء جملة Markdown العام ، مثل العلامات النجمية هي مجرد علامات نجمية ، مما يعني أنه يمكنك بسهولة كتابة الملفات ذات الصلة ببنية Markdown في صيغة Markdown.

مقسم

你 可以 在 一行 中用 三个 以上 的 星 号 、 减号 、 底线 来 建立 一个 分隔线 内 内 其他。 你 也 可以 号 或是 减号 中间 插入 空格。 下面 每种 写法 都 可以 建立分隔线 ：

* * *

***

*****

- - -

---------------------------------------

عنصر القسم

链接

يدعم Markdown شكلين من بناء جملة الارتباط: في النسقوالمرجعيشكلين.

وفي كلتا الحالتين ، يتم تمييز نص الارتباط بـ [أقواس مربعة].

لخلقفي النسقإذا كنت تريد إضافة نص العنوان للارتباط ، فقم فقط بلف نص العنوان بعلامات اقتباس مزدوجة بعد عنوان URL ، على سبيل المثال:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

سوف ينتج:

<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>

<p><a href="http://example.net/">This link</a> has no
title attribute.</p>

إذا كنت تقوم بالارتباط بالموارد الموجودة على نفس المضيف ، فيمكنك استخدام المسارات النسبية:

See my [About](/about/) page for details.

المرجعيالارتباط متبوع بقوس مربع آخر بعد قوس نص الرابط ، ويجب ملء العلامة المستخدمة لتعريف الارتباط في القوس المربع الثاني:

This is [an example][id] reference-style link.

يمكنك أيضًا وضع مسافة اختياريًا بين قوسين مربعين:

This is [an example] [id] reference-style link.

بعد ذلك ، في أي مكان في الملف ، يمكنك تحديد محتوى ارتباط هذه العلامة:

[id]: http://example.com/  "Optional Title Here"

يتم تعريف محتوى الارتباط في النموذج:

• أقواس مربعة (مسبوقة اختياريًا بما يصل إلى ثلاث مسافات للمسافة البادئة) يتم إدخال نص الارتباط فيها
• متبوعًا بنقطتين
• متبوعة بمسافة أو علامة تبويب واحدة أو أكثر
• عنوان URL للرابط التالي
• اختياريًا اتبع محتوى العنوان ، والذي يمكن تضمينه بين علامتي اقتباس مفردتين أو علامات اقتباس مزدوجة أو أقواس

تعريفات الروابط الثلاثة التالية هي نفسها:

[foo]: http://example.com/  "Optional Title Here"
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

الحذر:هناك مشكلة معروفة حيث يتجاهل Markdown.pl 1.0.1 عناوين الارتباط المضمنة في علامات اقتباس مفردة.

يمكن أيضًا وضع عناوين URL للارتباط بين أقواس زاوية:

[id]: <http://example.com/>  "Optional Title Here"

يمكنك أيضًا وضع سمة العنوان في السطر التالي ، أو إضافة مسافة بادئة ، والتي ستبدو أفضل إذا كان عنوان URL طويلًا جدًا:

[id]: http://example.com/longish/path/to/resource/here
    "Optional Title Here"

يتم استخدام تعريف URL فقط عند إنشاء الارتباط ، ولا يظهر مباشرة في الملف.

قد تحتوي علامات تعريف الارتباط على أحرف وأرقام ومسافات بيضاء وعلامات ترقيم ، ولكنها لا تحتوي على ذلكليسإنه حساس لحالة الأحرف ، لذا فإن الرابطين التاليين متماثلان:

[link text][a]
[link text][A]

علامة الارتباط الضمنيتتيح لك الميزة حذف تحديد علامة ارتباط. في هذه الحالة ، سيتم التعامل مع علامة الارتباط على أنها مكافئة لنص الرابط. لاستخدام علامة ارتباط ضمنية ، ما عليك سوى إضافة قوس مربع فارغ بعد نص الرابط. إذا كنت تريد "Google "الربط بموقع google.com ، يمكنك تبسيط ما يلي:

[Google][]

ثم حدد محتوى الارتباط:

[Google]: http://google.com/

نظرًا لأن نص الرابط قد يحتوي على مسافة بيضاء ، فقد يحتوي هذا الترميز المبسط على عدة كلمات:

Visit [Daring Fireball][] for more information.

ثم انتقل لتحديد الارتباط:

[Daring Fireball]: http://daringfireball.net/

يمكن وضع تعريف الارتباط في أي مكان بالملف ، وأنا أفضل وضعه بعد الفقرة التي يظهر فيها الرابط مباشرة ، كما يمكنك وضعه في نهاية الملف ، تمامًا مثل التعليق.

فيما يلي مثال على ارتباط مرجعي:

I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].

  [1]: http://google.com/        "Google"
  [2]: http://search.yahoo.com/  "Yahoo Search"
  [3]: http://search.msn.com/    "MSN Search"

إذا قمت بتغييره لاستخدام اسم الارتباط لكتابة:

I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].

  [google]: http://google.com/        "Google"
  [yahoo]:  http://search.yahoo.com/  "Yahoo Search"
  [msn]:    http://search.msn.com/    "MSN Search"

ستنتج الطريقتان المذكورتان أعلاه في كتابة HTML التالية.

<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>

يوجد أدناه ملف Markdown لنفس المحتوى مكتوبًا في الصفحة ، مقدمًا للمقارنة:

I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").

في الواقع ، لا تكمن نقطة ارتباطات النمط المرجعي في سهولة الكتابة ، بل في سهولة قراءتها. قارن المثال أعلاه. تتألف مقالة نمط المرجع نفسها من 81 حرفًا فقط ، ولكن سيزداد النموذج المضمن إلى 176 حرفًا ، إذا تمت كتابتها بتنسيق HTML خالص ، فسيكون هناك 234 حرفًا.في تنسيق HTML ، هناك علامات أكثر من النص.

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

强调

يستخدم Markdown العلامات النجمية (*) والنتيجة النهائية (_) كرمز لتمييز كلمة تحتها خط ، هو * 或 _ يتم تحويل الكلمات المحيطة إلى <em> محاطة بتسميات ، مع اثنتين * 或 _إذا تم لفه ، فسيتم تحويله إلى <strong>، على سبيل المثال:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

سوف يتحول إلى:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

يمكنك استخدام أي نمط تريده ، والقيد الوحيد هو أنه يمكنك استخدام الرمز لفتح العلامة والرمز لإنهائها.

يمكن أيضًا إدراج التوكيد مباشرة في منتصف النص:

un*frigging*believable

لكنإذا كان لديك * و _ إذا كانت هناك مسافة بيضاء على كلا الجانبين ، فسيتم التعامل معها كرموز عادية.

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

\*this text is surrounded by literal asterisks\*

الشفرة

إذا كنت تريد وضع علامة على جزء صغير من التعليمات البرمجية المضمنة ، فيمكنك لفه في backticks (`) ، على سبيل المثال:

Use the `printf()` function.

سوف ينتج:

<p>Use the <code>printf()</code> function.</p>

إذا كنت ترغب في إدراج backticks داخل قسم التعليمات البرمجية ، فيمكنك بدء قسم التعليمات البرمجية وإنهائه باستخدام backticks متعددة:

``There is a literal backtick (`) here.``

ينتج عن بناء الجملة هذا:

<p><code>There is a literal backtick (`) here.</code></p>

يمكنك وضع فراغ في بداية ونهاية قسم الكود ، واحدًا بعد البداية والآخر قبل النهاية ، بحيث يمكنك إدخال backticks في بداية القسم:

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

سوف ينتج:

<p>A single backtick in a code span: <code>`</code></p>

<p>A backtick-delimited string in a code span: <code>`foo`</code></p>

داخل قسم الكود ،& وأقواس زاوية都سيتم تحويله تلقائيًا إلى كيانات HTML ، مما يجعل من السهل إدخال كود مصدر HTML ، سيضع Markdown الفقرة التالية:

Please don't use any `<blink>` tags.

إلى:

<p>Please don't use any <code><blink></code> tags.</p>

يمكنك أيضًا كتابة هذا:

`—` is the decimal-encoded equivalent of `—`.

لانتاج:

<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>

图片

من الواضح أنه من الصعب تصميم بناء جملة "طبيعي" لإدراج الصور في تطبيق نصي فقط.

يستخدم Markdown صيغة مشابهة لتلك الخاصة بالروابط لترميز الصور ، ويسمح أيضًا بنمطين: في النسقوالمرجعي.

تبدو بنية الصورة المضمنة كما يلي:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

وفيما يلي التفاصيل:

• علامة تعجب !
• 一个 方 括号 ， 里面 放上 图片 的 替代 文字
• ويتبع ذلك أقواس عادية مع عنوان URL للصورة ، وأخيرًا نص "عنوان" اختياري محاط بعلامات اقتباس.

تبدو صيغة الصورة المرجعية كما يلي:

![Alt text][id]

"المعرف" هو اسم مرجع الصورة ، والذي يتم تعريفه بنفس طريقة مرجع الارتباط:

[id]: url/to/image  "Optional title attribute"

حتى الآن ، لا توجد طريقة Markdown لتحديد عرض الصورة وارتفاعها ، إذا كنت بحاجة ، يمكنك استخدام الوضع العادي <img> ضع الكلمة المناسبة.

其它

ارتباط تلقائي

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

<http://example.com/>

سيتم تحويل Markdown إلى:

<a href="http://example.com/">http://example.com/</a>

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

<[email protected]>

سوف يتحول Markdown إلى:

<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>

في المتصفح ، هذه السلسلة (في الواقع <a href="mailto:[email protected]">[email protected]</a>) يصبح ارتباط "[email protected]" قابلاً للنقر.

(على الرغم من أن هذا الأسلوب يمكن أن يخدع الكثير من الروبوتات ، إلا أنه لا يمكنه إيقافهم جميعًا ، ولكنه أفضل من لا شيء. على أي حال ، سيؤدي فتح صندوق البريد الخاص بك في النهاية إلى جذب رسائل إعلانية).

شرطة مائلة للخلف

يمكن أن تستخدم Markdown خطوط مائلة عكسية لإدراج الرموز التي لها معاني أخرى في القواعد ، على سبيل المثال: إذا كنت تريد إضافة علامة النجمة بجوار النص للتأكيد (ولكن ليس <em> tag) ، يمكنك أن تسبق علامة النجمة بشرطة مائلة للخلف:

\*literal asterisks\*

تخفيض السعر 支持 以下 这些 符号 前面 加上 反斜杠 来 帮助 插入 普通 的 符号 ：

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

محرر Markdown المجاني

منصة ويندوز

• تخفيض السعر
• مارك باد

منصة ماك

• مذكرة تفاهم

محرر على الإنترنت

• MPEditor

متصفح البرنامج المساعد

• Markdown هنا البرنامج المساعد

*** إذا كان هناك محرر Markdown مجاني أفضل للتوصية به ، فيرجى الانتباه إلى التعليقات الواردة إليهتشن ويليانج،شكرا!