مطلب ڇا آھي Markdown ڇا آھي؟ مارڪ ڊائون نحو/فارميٽ مارڪ اپ ڪيئن استعمال ڪجي؟

Markdownڇا مطلب؟

مارڪ ڊائون نحو/فارميٽنگ مارڪ اپ ڪيئن استعمال ڪجي؟

جائزو

مارڪ ڊائون هڪ ٿلهي مارڪ اپ ٻولي آهي جيڪا جان گروبر پاران ٺاهي وئي آهي.

اهو ماڻهن کي اجازت ڏئي ٿو ته "دستاويزن کي هڪ سادي متن جي شڪل ۾ لکڻ لاء جيڪو پڙهڻ ۽ لکڻ ۾ آسان آهي، ۽ پوء انهن کي درست XHTML (يا HTML) دستاويزن ۾ تبديل ڪريو".

ٻولي اڳ ۾ ئي اي ميل ۾ مليل سادي متن مارڪ اپ جي ڪيترن ئي خاصيتن کي جذب ڪيو آهي.

جان گروبر 2004 ۾ مارڪ ڊائون ٻولي ٺاهي، هارون سوارٽز جي تعاون سان گرامر تي وڏي حصي ۾.ٻولي جو مقصد استعمال ڪرڻ آهي "هڪ سادي ٽيڪسٽ فارميٽ جيڪا پڙهڻ ۾ آسان، لکڻ ۾ آسان، ۽ اختياري طور تي صحيح XHTML (يا HTML) ۾ تبديل ٿئي ٿي".

مقصد

مارڪ ڊائون جو مقصد "پڙهڻ ۾ آسان ۽ لکڻ ۾ آسان" آهي.

پڙهڻ جي قابليت، ڪنهن به صورت ۾ ڪريوانٽرنيٽ مارڪيٽنگ، استعمال ڪندڙ جو تجربو تمام ضروري آهي.

مارڪ ڊائون ۾ لکيل هڪ دستاويز سڌو سنئون متن ۾ شايع ٿيڻ جي قابل هوندو، ۽ ظاهر نه ٿيڻ گهرجي ڪيترن ئي ٽيگ يا فارميٽنگ جي هدايتن مان ٺهيل هجي.

مارڪ ڊائون نحو ڪجهه موجوده متن کان HTML فارميٽ تي اثر انداز ٿئي ٿو، جنهن ۾ Setext، atx، Textile، restructuredText، Grutatext، ۽ EtText شامل آهن، پر انسپائريشن جو سڀ کان وڏو ذريعو سادي ٽيڪسٽ اي ميل فارميٽ آهي.

مختصر ۾، مارڪ ڊائون جو نحو سڀ نشانين تي مشتمل آهي، جيڪي احتياط سان چونڊيل آهن ۽ انهن جا ڪم هڪ نظر ۾ واضح آهن.مثال طور: ٽيڪسٽ جي چوڌاري ستارن کي وجھو ته جيئن ان کي * زور * وانگر نظر اچي.

مارڪ ڊائون ۾ لسٽون نظر اچن ٿيون، سٺيون، فهرستون. مارڪ ڊائون ۾ بلاڪ ڪوٽس حقيقت ۾ ٽيڪسٽ جي هڪ ٽڪري کي نقل ڪرڻ وانگر نظر اچن ٿا، جيئن توهان اي ميلن ۾ ڏٺو آهي.

HTML سان مطابقت

مارڪ ڊائون گرامر جو مقصد ويب لاءِ لکڻ جي ٻولي آھي.

مارڪ ڊائون جو مطلب HTML کي تبديل ڪرڻ يا ان جي ويجهو اچڻ جو مطلب ناهي، ان ۾ تمام ٿورڙو نحو آهي ۽ صرف HTML مارڪ اپ جي هڪ ننڍڙي سبسٽ سان ملندڙ جلندڙ آهي. HTML دستاويزن کي لکڻ لاءِ آسان بڻائڻ لاءِ مارڪ ڊائون جو تصور نه ڪيو ويو.

منهنجي خيال ۾، HTML اڳ ۾ ئي لکڻ آسان آهي. مارڪ ڊائون جو خيال دستاويزن کي پڙهڻ، لکڻ ۽ پنهنجي مرضيءَ سان تبديل ڪرڻ آسان بنائڻ آهي. HTML هڪ پبلشنگ فارميٽ آهي، مارڪ ڊائون هڪ آهيڪاپي رائيٽنگلکيل فارميٽ.جيئن ته، مارڪ ڊائون جي فارميٽنگ نحو صرف ڍڪي ٿو ته ڇا سادي متن ڪري سگھي ٿو.

ٽيگ جيڪي شامل نه ڪيا ويا آهن مارڪ ڊائونڊ طرفان سڌو سنئون دستاويز ۾ HTML ۾ لکي سگهجي ٿوويب پروموشنڪاپي.ھن کي HTML يا Markdown طور نشان ھڻڻ جي ڪا ضرورت نھ آھي؛ بس سڌو مارڪ اپ شامل ڪريو.

صرف ڪجهه HTML بلاڪ عناصر کي محدود ڪيو وڃي - جهڙوڪ <div>،<table>،<pre>،<p> ۽ ٻيا ٽيگ، انهن کي لازمي طور تي ٻين مواد وارن علائقن کان خالي لڪير کان اڳ ۽ بعد ۾ الڳ ڪيو وڃي، ۽ انهن جي کولڻ ۽ بند ڪرڻ واري ٽيگ کي لازمي طور تي ٽيب يا اسپيس سان نه لڳايو وڃي. مارڪ ڊائون جنريٽر ڪافي هوشيار آهي غير ضروري HTML بلاڪ ٽيگ شامل ڪرڻ لاءِ <p> ليبل

مثال هن ريت آهي، مارڪ ڊائون فائل ۾ HTML ٽيبل شامل ڪرڻ:

这是一个普通段落。

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

这是另一个普通段落。

نوٽ ڪريو ته HTML بلاڪ ٽيگ جي وچ ۾ مارڪ ڊائون فارميٽنگ نحو تي عمل نه ڪيو ويندو.مثال طور، جيڪڏهن توهان HTML بلاڪ جي اندر مارڪ ڊائون اسلوب استعمال ڪريو ٿا*强调*اثر نه ٿيندو.

HTML سيڪشن (ان لائن) ٽيگ جيئن <span>،<cite>،<del> مارڪ ڊائون پيراگراف، فهرستن يا عنوانن ۾ آزاد طور تي استعمال ڪري سگھجي ٿو.ذاتي عادتن جي مطابق، توهان مارڪ ڊائون فارميٽ استعمال ڪرڻ کان سواءِ فارميٽ ڪرڻ لاءِ HTML ٽيگ پڻ استعمال ڪري سگهو ٿا.مثال: جيڪڏهن توهان HTML کي ترجيح ڏيو ٿا <a> يا نه <img> ٽيگ، جيڪي مارڪ ڊائون پاران مهيا ڪيل لنڪ يا تصويري ٽيگ نحو کان سواءِ سڌو استعمال ڪري سگھجن ٿا.

HTML بلاڪ ٽيگ جي وچ ۾ برعڪس، مارڪ ڊائون نحو 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 معيار جي تصديق جي ذريعي معلوم ڪيل غلطين جو سڀ کان وڏو تعداد.

مارڪ ڊائون توهان کي قدرتي طور تي ڪردارن کي لکڻ جي اجازت ڏئي ٿو، ۽ اهو خيال رکي ٿو ته ڇا تبديل ٿيڻ جي ضرورت آهي.جيڪڏهن توهان استعمال ڪريو & هڪ ڪردار HTML ڪردار جي اداري جو حصو آهي، ان کي ڇڏي ڏنو ويو آهي، ٻي صورت ۾ ان کي تبديل ڪيو ويندو &؛.

تنهن ڪري جيڪڏهن توهان دستاويز ۾ ڪاپي رائيٽ جي علامت داخل ڪرڻ چاهيو ٿا ©، توهان لکي سگهو ٿا:

©

مارڪ ڊائون ان کي اڻڄاتل ڇڏيندو.۽ جيڪڏهن توهان لکندا آهيو:

AT&T

Markdown ان کي تبديل ڪندو:

AT&T

ساڳي صورتحال سنڌ ۾ پڻ ٿئي ٿي < نوٽيفڪيشن، ڇاڪاڻ ته مارڪ ڊائون HTML مطابقت جي اجازت ڏئي ٿو، جيڪڏهن توهان لڳايو < علامتون HTML ٽيگ لاءِ ڊيليميٽر طور استعمال ڪيون وينديون آهن، ۽ مارڪ ڊائون انهن تي ڪا به تبديلي نه ڪندو، پر جيڪڏهن توهان لکندا آهيو:

4 < 5

Markdown ان کي تبديل ڪندو:

4 < 5

بهرحال، اهو ياد رکڻ گهرجي ته ڪوڊ جي دائري ۾، ڇا اهو ان لائن آهي يا بلاڪ، < ۽ & ٻئي علامتونلازميHTML ادارن ۾ تبديل ٿي ويا آهن، هڪ خاصيت جيڪا توهان کي آساني سان HTML ڪوڊ لکڻ جي اجازت ڏئي ٿي مارڪ ڊائون ۾ (جيئن ته HTML جي مخالفت، جتي توهان سڀ < ۽ & HTML فائل ۾ HTML ڪوڊ لکڻ لاءِ سڀئي HTML ادارن ۾ تبديل ڪيا ويا آهن. )

بلاڪ عنصر

پيراگراف ۽ لائن ٽوڪ

مارڪ ڊائون پيراگراف متن جي هڪ يا وڌيڪ لڳاتار لائينن تي مشتمل هوندو آهي، هڪ کان وڌيڪ خالي لڪير کان اڳ ۽ پٺيان (خالي لڪير جي تعريف اها آهي ته اها ڊسپلي تي خالي نظر اچي ٿي ۽ هڪ خالي لڪير سمجهي وڃي ٿي. مثال طور، ، جيڪڏهن هڪ لڪير ۾ صرف اسپيس ۽ ٽيب شامل آهن، ليڪ پڻ هڪ خالي لڪير وانگر علاج ڪيو ويندو).عام پيراگرافن کي اسپيس يا ٽيب سان نه لڳايو وڃي.

جملي ”متن جي هڪ يا وڌيڪ لڳاتار لائينن تي مشتمل آهي“ اصل ۾ مطلب اهو آهي ته مارڪ ڊائون پيراگرافن ۾ زبردستي نيون لائينون (نئين لائنن جي داخل ڪرڻ) جي اجازت ڏئي ٿو، هڪ خاصيت جيڪا ٻين متن کان HTML فارميٽ کان مختلف آهي (بشمول Movable Type "Convert Line Breaks. "اختيار)، ٻيون شڪلون هر لائين برڪ ۾ تبديل ڪندا <br /> ليبل

جيڪڏهن اوهانواقعيداخل ڪرڻ لاءِ مارڪ ڊائون تي ڀروسو ڪرڻ چاهيو ٿا <br /> ليبل لاءِ، داخل ڪرڻ واري جاءِ تي ٻه يا وڌيڪ اسپيس کي دٻايو ۽ پوءِ Enter کي دٻايو.

درحقيقت، اهو ٿورڙو وڌيڪ ڪم وٺندو آهي (اضافي جاء) پيدا ڪرڻ لاء <br /> ، پر صرف "هر نئين لائن کي تبديل ڪيو ويو آهي <br />"طريقو مارڪ ڊائون ۾ مناسب ناهي، ايم مارڪ ڊائونڊ ۾aiL-style blockquotes ۽ گھڻن پيراگراف لسٽون نه رڳو وڌيڪ ڪارائتيون آھن پر پڙھڻ ۾ پڻ آسان آھن جڏھن ٽائپ سيٽنگ لائن بريڪ سان.

标题

مارڪ ڊائون هيڊنگ لاءِ ٻن نحو کي سپورٽ ڪري ٿو، 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

مارڪ ڊائون مارڪ اپ بلاڪ ڪوٽس استعمال ڪيا ويا آهن جيڪي اي ميل ۾ استعمال ٿيل آهن > حوالن جي.جيڪڏهن توهان اي ميل خطن ۾ اقتباسات کان واقف آهيو، توهان کي خبر آهي ته ڪيئن هڪ بلاڪ اقتباس ٺاهي هڪ مارڪ ڊائون فائل ۾، جيڪو ڏسڻ ۾ اچي ٿو ته توهان لائنن کي پاڻ کي ٽوڙيو، پوء شامل ڪريو > :

> 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 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.

ٻيا مارڪ ڊائون نحو پڻ استعمال ڪري سگھجن ٿا حوالن واري بلاڪ ۾، بشمول عنوان، لسٽون، ڪوڊ بلاڪ، وغيره.

> ## 这是一个标题。
> 
> 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 ٻاھر.نقطو اهو آهي ته، توهان مارڪ ڊائون فائل ۾ لسٽ نمبر ٺاهي سگهو ٿا ساڳيو ئي آئوٽ پُٽ نتيجا، يا جيڪڏهن توهان سست آهيو، توهان کي انگن جي درستي جي پرواهه ڪرڻ جي ضرورت ناهي.

جيڪڏھن توھان سست لکڻ استعمال ڪندا آھيو، اھو تجويز ڪيو ويو آھي ته 1 سان شروع ڪريو. پھرين شيون لاءِ، ڇاڪاڻ ته مارڪ ڊائون مستقبل ۾ ترتيب ڏنل فهرستن جي شروعاتي خاصيت کي سپورٽ ڪري سگھي ٿو.

لسٽ آئٽم ٽيگ عام طور تي پري کاٻي پاسي رکيل هوندو آهي، پر ان کي 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.

جيڪڏهن فهرست جون شيون خالي لائينن سان الڳ ڪيون ويون آهن، مارڪ ڊائون آئٽم مواد استعمال ڪندو جڏهن 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 ٽئب ذريعي داخل ٿيڻ گھرجي:

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.

اهو تمام گهڻو بهتر ڏسڻ ۾ اچي ٿو جيڪڏهن توهان هر لڪير کي ڇڪايو، يقينا، ٻيهر، جيڪڏهن توهان سست آهيو، مارڪ ڊائون پڻ اجازت ڏئي ٿو:

*   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 اسپيس يا 2 ٽيب آهي:

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

        <代码写在这>

يقينن، شين جي هڪ فهرست حادثي سان پيدا ٿي سگهي ٿي، ڪجهه هن طرح:

1986. What a great season.

ٻين لفظن ۾، اهو لڪير جي شروعات ۾ ظاهر ٿئي ٿونمبر-مدت-خالي, هن کان بچڻ لاء, توهان جي دور کان اڳ هڪ backslash شامل ڪري سگهو ٿا.

1986\. What a great season.

ڪوڊ بلاڪ

پروگرام سان لاڳاپيل لکڻين يا ٽيگ ٻوليءَ جو سورس ڪوڊ عام طور تي اڳ ۾ ئي ٽائپ سيٽ ڪوڊ بلاڪ هوندو آهي. عام طور تي، اسان نٿا چاهيون ته اهي بلاڪ عام پيراگراف فائلن جي طريقي سان ٽائپسيٽ ٿين، پر انهن کي ڏيکاريون جيئن اهي آهن. مارڪ ڊائون استعمال ڪندا. <pre> ۽ <code> tags to wrap code blocks.

مارڪ ڊائون ۾ ڪوڊ جا بلاڪ ٺاهڻ 4 اسپيس يا 1 ٽئب کي انڊيٽنگ ڪرڻ جيترو سادو آهي، مثال طور، هيٺيون داخل ڪريو:

这是一个普通段落：

    这是一个代码区块。

Markdown ۾ تبديل ٿيندو:

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

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

هي پهريون آرڊر انڊينٽيشن في ليڪ (4 اسپيس يا 1 ٽيب) هٽايو ويو آهي، مثال طور:

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 ادارن ۾ تبديل ٿي ويندو. اهو طريقو توهان لاءِ تمام آسان بڻائي ٿو مارڪ ڊائون استعمال ڪرڻ لاءِ HTML سورس ڪوڊ داخل ڪرڻ لاءِ مثال طور، صرف ان کي ڪاپي ۽ پيسٽ ڪريو، انڊينٽيشن شامل ڪريو، ۽ باقي مارڪ ڊائون ان کي سنڀاليندو، توهان لاءِ. مثال:

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

۾ تبديل ڪيو ويندو:

<pre><code><div class="footer">
    &copy; 2004 Foo Corporation
</div>
</code></pre>

ڪوڊ بلاڪ ۾، عام مارڪ ڊائون نحو کي تبديل نه ڪيو ويندو، جيئن ته Asterisks صرف Asterisks آهن، جنهن جو مطلب آهي ته توهان آساني سان مارڪ ڊائون نحو سان لاڳاپيل فائلن کي مارڪ ڊائونڊ نحو ۾ لکي سگهو ٿا.

ورهائيندڙ

توهان هڪ ورهائيندڙ ٺاهي سگهو ٿا ٽن کان وڌيڪ ستارن، مائنس نشانين، هڪ لڪير ۾ هيٺيون، قطار ۾ ٻيو ڪجهه به نه.توهان ستارن يا مائنس نشانين جي وچ ۾ خال پڻ داخل ڪري سگهو ٿا.علحدگيءَ جون لائينون لکڻ جي ھيٺين طريقن مان ھر ھڪ ۾ ٺاھي سگھجن ٿيون.

* * *

***

*****

- - -

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

سيڪشن جو عنصر

لنڪ

مارڪ ڊائون لنڪ نحو جي ٻن شڪلن کي سپورٽ ڪري ٿو: ان لائن۽حوالوٻه روپ.

ڪنهن به صورت ۾، لنڪ ٽيڪسٽ نشان لڳل آهي [مربع بریکٹ] سان.

ٺاهڻ لاءِان لائنجيڪڏهن توهان لنڪ جي ٽائيٽل ٽيڪسٽ شامل ڪرڻ چاهيو ٿا، صرف عنوان جي متن کي 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"

لنڪ مواد فارم ۾ بيان ڪيو ويو آهي:

• اسڪوائر بریکٹس (اختياري طور تي اڳ ۾ ٽن اسپيس تائين انڊينٽيشن لاءِ) جنهن ۾ لنڪ ٽيڪسٽ داخل ڪيو ويو آهي
• هڪ colon جي پٺيان
• هڪ يا وڌيڪ اسپيس يا ٽيب جي پٺيان
• ايندڙ لنڪ جو 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 ھڪڙي حوالن ۾ بند ٿيل لنڪ عنوانن کي نظرانداز ڪري ٿو.

لنڪ URLs پڻ زاوي بریکٹ ۾ بند ڪري سگھجن ٿيون:

[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.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>

هيٺ ڏنل ساڳئي مواد جي مارڪ ڊائون فائل ان لائن لکيل آهي، مقابلي لاءِ مهيا ڪيل آهي:

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 فارميٽ ۾ ٽيڪسٽ کان وڌيڪ ٽيگ هوندا آهن.

مارڪ ڊائون جي حوالن واري طرز جي لنڪس کي استعمال ڪندي، توهان دستاويز کي وڌيڪ برائوزر جي آخري نتيجي وانگر ٺاهي سگهو ٿا، توهان کي ڪجهه مارڪ اپ سان لاڳاپيل ميٽا ڊيٽا کي پيراگراف ٽيڪسٽ کان ٻاهر منتقل ڪرڻ جي اجازت ڏئي ٿي، ۽ توهان مضمون جي پڙهڻ کي محسوس ڪرڻ کانسواءِ لنڪ شامل ڪري سگهو ٿا. .

زور ڀريو

مارڪ ڊائون اسٽريڪ استعمال ڪري ٿو (*) ۽ هيٺيون لڪير (_) هڪ علامت جي طور تي هڪ هيٺ ڏنل لفظ کي نشان ڏيڻ لاء، آهي * يا نه _ چوڌاري لفظن ۾ تبديل ٿي ويا آهن <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\*

ليڊ

جيڪڏهن توهان ان لائن ڪوڊ جي هڪ ننڍڙي ٽڪري کي نشانو بڻائڻ چاهيو ٿا، ته توهان ان کي بيڪ ٽِڪس ۾ لپي سگهو ٿا (`)، مثال طور:

Use the `printf()` function.

پيدا ڪندو:

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

جيڪڏهن توهان ڪوڊ سيڪشن ۾ بيڪ ٽڪس داخل ڪرڻ چاهيو ٿا، ته توهان ڪوڊ سيڪشن کي شروع ۽ ختم ڪري سگهو ٿا ڪيترن ئي بيڪ ٽڪس سان:

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

هي نحو پيدا ڪري ٿو:

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

توهان ڪوڊ سيڪشن جي شروعات ۽ آخر ۾ هڪ خالي رکي سگهو ٿا، هڪ شروعات کان پوءِ ۽ هڪ آخر کان اڳ، تنهنڪري توهان سيڪشن جي شروعات ۾ بيڪ ٽڪس داخل ڪري سگهو ٿا:

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 سورس ڪوڊ داخل ڪرڻ آسان بڻائي ٿو، مارڪ ڊائون ھيٺ ڏنل پيراگراف رکندو:

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>&#8212;</code> is the decimal-encoded
equivalent of <code>&mdash;</code>.</p>

图片

ظاهر آهي، صرف ٽيڪسٽ ايپليڪيشن ۾ تصويرون داخل ڪرڻ لاءِ "قدرتي" نحو ٺاهڻ ڏکيو آهي.

مارڪ ڊائون تصويرن کي نشانو بڻائڻ لاءِ لنڪس سان ملندڙ نحو استعمال ڪري ٿو، ۽ ٻن اندازن جي اجازت پڻ ڏئي ٿو: ان لائن۽حوالو.

ان لائن تصويري نحو ڏسڻ ۾ اچي ٿو:

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

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

تفصيل هن ريت آهن:

• هڪ عجب جو نشان !
• تصوير لاءِ alt متن سان گڏ چورس بریکٹ جي پٺيان
• ان کان پوءِ تصوير جي URL سان عام قوسون، ۽ آخر ۾ هڪ اختياري 'عنوان' متن اقتباس ۾ بند ٿيل آهي.

حوالو تصويري نحو هن طرح ڏسڻ ۾ اچي ٿو:

![Alt text][id]

"id" تصويري حوالن جو نالو آھي، جنھن کي ساڳي طرح بيان ڪيو ويو آھي ھڪڙي لنڪ ريفرنس جي طور تي:

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

هينئر تائين، مارڪ ڊائون کي تصوير جي چوٽي ۽ اوچائي بيان ڪرڻ جو ڪو طريقو ناهي، جيڪڏهن توهان کي ضرورت هجي، توهان استعمال ڪري سگهو ٿا عام <img> ليبل

其它

خودڪار لنڪ

مارڪ ڊائون پروسيسنگ URLs ۽ اي ميل ميل باڪسز کي نسبتا مختصر خودڪار لنڪ جي صورت ۾ سپورٽ ڪري ٿو. جيستائين اهي زاوي بریکٹ ۾ بند ٿيل آهن، مارڪ ڊائون خود بخود ان کي لنڪ ۾ تبديل ڪندو.عام URL جو لنڪ ٽيڪسٽ لنڪ ايڊريس جي برابر آهي، مثال طور:

<http://example.com/>

مارڪ ڊائون کي تبديل ڪيو ويندو:

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

اي ميل ايڊريس جو پاڻمرادو ڳنڍڻ به ساڳيو آهي، سواءِ ان جي ته مارڪ ڊائون پهريون ڀيرو انڪوڊنگ ڪنورشن جو عمل انجام ڏيندو، ٽيڪسٽ اکرن کي هيڪساڊسيمل HTML ادارن ۾ تبديل ڪندو. هي فارميٽ ڪجهه خراب اي ميل ايڊريس گڏ ڪرڻ واري روبوٽ کي بيوقوف بڻائي سگهي ٿو، جهڙوڪ:

<[email protected]>

مارڪ ڊائون ۾ تبديل ٿي ويندو:

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

برائوزر ۾، هي اسٽرنگ (اصل ۾ <a href="mailto:[email protected]">[email protected]</a>) ڪلڪ ڪري سگهجي ٿو "[email protected]" لنڪ.

(جيتوڻيڪ اهو طريقو ڪيترن ئي روبوٽ کي بيوقوف بڻائي سگهي ٿو، اهو انهن سڀني کي روڪي نٿو سگهي، پر اهو ڪنهن به صورت ۾ بهتر ناهي. ڪنهن به صورت ۾، توهان جي ميل باڪس کي کولڻ آخرڪار اشتهارن جي خطن کي راغب ڪندو.)

پٺڀرائي

مارڪ ڊائون علامتن کي شامل ڪرڻ لاءِ پٺتي سليش استعمال ڪري سگھي ٿو جيڪي گرامر ۾ ٻيون معنائون رکن ٿيون، مثال طور: جيڪڏهن توهان زور ڏيڻ لاءِ متن جي اڳيان هڪ ستاري شامل ڪرڻ چاهيو ٿا (پر نه <em> ٽيگ)، توهان هڪ پٺتي پيل سان ستاري کان اڳ ڪري سگهو ٿا:

\*literal asterisks\*

مارڪ ڊائون ھيٺ ڏنل علامتن کي سپورٽ ڪري ٿو جيڪو پوئتي سليش کان اڳ ۾ عام علامتون داخل ڪرڻ ۾ مدد لاءِ.

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

مارڪ ڊائون مفت ايڊيٽر

ونڊوز پليٽ فارم

• مارڪ ڊائون پيڊ
• مارڪ پيڊ

ميڪ پليٽ فارم

• نرم

آن لائن ايڊيٽر

• ايم پي ايڊيٽر

برائوزر پلگ ان

• هتي پلگ ان کي نشان لڳايو

*** جيڪڏھن آھي ھڪڙو بھتر مفت مارڪ ڊائون ايڊيٽر سفارش ڪرڻ لاءِ، مھرباني ڪري راءِ ڏانھن ڌيان ڏيوچن ويلانگ،مهرباني!