مارک ڈاؤن کا کیا مطلب ہے؟ مارک ڈاؤن نحو/فارمیٹنگ مارک اپ کا استعمال کیسے کریں؟

Markdownکیا اسباب؟

مارک ڈاؤن نحو/فارمیٹنگ مارک اپ کا استعمال کیسے کریں؟

جائزہ

مارک ڈاؤن ایک ہلکی پھلکی مارک اپ لینگویج ہے جسے جان گروبر نے بنایا ہے۔

یہ لوگوں کو "سادہ ٹیکسٹ فارمیٹ میں دستاویزات لکھنے کی اجازت دیتا ہے جو پڑھنے اور لکھنے میں آسان ہے، اور پھر انہیں درست XHTML (یا HTML) دستاویزات میں تبدیل کریں"۔

یہ زبان سادہ ٹیکسٹ مارک اپ کی بہت سی خصوصیات کو شامل کرتی ہے جو پہلے سے ای میل میں موجود ہیں۔

جان گروبر نے 2004 میں نحو پر ہارون سوارٹز کے ساتھ مل کر مارک ڈاؤن زبان بنائی۔زبان کا مقصد "ایک سادہ ٹیکسٹ فارمیٹ جو پڑھنے میں آسان، لکھنے میں آسان، اور اختیاری طور پر درست XHTML (یا HTML) میں تبدیل ہو جائے" کا استعمال کرنا ہے۔

مقصد

مارک ڈاؤن کا مقصد "پڑھنے میں آسان اور لکھنے میں آسان" ہونا ہے۔

پڑھنے کی اہلیت، ویسے بھی کرو网络 营销، صارف کا تجربہ بہت اہم ہے۔

مارک ڈاون میں لکھی گئی دستاویز کو براہ راست سادہ متن میں شائع کرنے کے قابل ہونا چاہیے، اور یہ بہت سے ٹیگز یا فارمیٹنگ کی ہدایات پر مشتمل نہیں ہونا چاہیے۔

مارک ڈاؤن نحو کچھ موجودہ ٹیکسٹ ٹو ایچ ٹی ایم ایل فارمیٹس سے متاثر ہوتا ہے، بشمول Setext، atx، Textile، restructuredText، Grutatext، اور EtText، لیکن الہام کا سب سے بڑا ذریعہ سادہ ٹیکسٹ ای میل فارمیٹ ہے۔

مختصراً، مارک ڈاؤن کا نحو تمام علامتوں پر مشتمل ہے، جنہیں احتیاط سے منتخب کیا گیا ہے اور ان کے افعال ایک نظر میں واضح ہیں۔مثال کے طور پر: متن کے ارد گرد ستارے لگائیں تاکہ اسے *زور* کی طرح نظر آئے۔

مارک ڈاؤن میں فہرستیں، فہرستوں کی طرح نظر آتی ہیں۔ مارک ڈاون میں بلاک کوٹس واقعی متن کے کسی ٹکڑے کا حوالہ دیتے ہوئے نظر آتے ہیں، جیسا کہ آپ نے ای میلز میں دیکھا ہے۔

HTML کے ساتھ ہم آہنگ

مارک ڈاؤن گرامر کا مقصد ویب کے لیے تحریری زبان بننا ہے۔

مارک ڈاؤن کا مقصد HTML کو تبدیل کرنا یا اس کے قریب آنا نہیں ہے، اس میں نحو کی بہت کم اقسام ہیں اور یہ HTML مارک اپ کے صرف ایک چھوٹے سے ذیلی سیٹ سے مساوی ہے۔ HTML دستاویزات کو لکھنے میں آسان بنانے کے لیے مارک ڈاؤن کا تصور نہیں کیا گیا تھا۔

میری رائے میں، HTML پہلے سے ہی لکھنا آسان ہے۔ مارک ڈاؤن کا خیال دستاویزات کو پڑھنے، لکھنے اور اپنی مرضی سے تبدیل کرنے میں آسانی پیدا کرنا ہے۔ ایچ ٹی ایم ایل ایک اشاعت کی شکل ہے، مارک ڈاؤن ایک ہے۔کاپی رائٹنگتحریری شکل.اس طرح، مارک ڈاؤن کا فارمیٹنگ نحو صرف اس بات کا احاطہ کرتا ہے جو سادہ متن کر سکتا ہے۔

وہ ٹیگز جو مارک ڈاون میں شامل نہیں ہیں وہ براہ راست دستاویز میں HTML میں لکھے جا سکتے ہیں۔ویب پروموشنکاپیاسے HTML یا Markdown کے بطور نشان زد کرنے کی ضرورت نہیں ہے؛ صرف مارک اپ کو براہ راست شامل کریں۔

صرف کچھ HTML بلاک عناصر کو محدود کرنا ہے - جیسے <div>،<table>،<pre>،<p> اور دیگر ٹیگز، انہیں دوسرے مواد والے علاقوں سے پہلے اور بعد میں خالی لائنوں کے ساتھ الگ ہونا چاہیے، اور ان کے افتتاحی اور بند ہونے والے ٹیگز کو ٹیبز یا اسپیس کے ساتھ انڈینٹ نہیں کرنا چاہیے۔ مارک ڈاؤن جنریٹر اتنا ہوشیار ہے کہ غیر ضروری HTML بلاک ٹیگز شامل نہ کرے۔ <p> لیبل

مارک ڈاون فائل میں ایچ ٹی ایم ایل ٹیبل کا اضافہ کرتے ہوئے مثال درج ذیل ہے۔

这是一个普通段落。

<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

آپ کو یو آر ایل کی تبدیلی اس طرح لکھنی ہوگی:

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

لنک ٹیگ میں رکھا جائے۔ href خصوصیات میں.یہ کہنے کی ضرورت نہیں کہ اس کو نظر انداز کرنا آسان ہے، اور شاید HTML معیارات کی توثیق کے ذریعے پائی جانے والی غلطیوں کی سب سے بڑی تعداد۔

مارک ڈاؤن آپ کو قدرتی طور پر حروف لکھنے کی اجازت دیتا ہے، اور یہ اس بات کا خیال رکھتا ہے کہ کن چیزوں کو تبدیل کرنے کی ضرورت ہے۔اگر آپ استعمال کرتے ہیں & ایک کریکٹر ایچ ٹی ایم ایل کریکٹر ہستی کا حصہ ہوتا ہے، اسے ویسا ہی چھوڑ دیا جاتا ہے، بصورت دیگر اس میں تبدیل ہوجاتا ہے۔ &;.

لہذا اگر آپ دستاویز میں کاپی رائٹ کی علامت ڈالنا چاہتے ہیں۔ ©، تم لکھ سکتے ہو:

©

مارک ڈاؤن اسے اچھوت چھوڑ دے گا۔اور اگر آپ لکھتے ہیں:

AT&T

مارک ڈاؤن اسے اس میں تبدیل کر دے گا:

AT&T

میں بھی ایسی ہی صورت حال پائی جاتی ہے۔ < نوٹیشن، چونکہ مارک ڈاؤن HTML مطابقت کی اجازت دیتا ہے، اگر آپ ڈالتے ہیں۔ < علامات کو HTML ٹیگز کے لیے حد بندی کے طور پر استعمال کیا جاتا ہے، اور مارک ڈاؤن ان پر کوئی تبدیلی نہیں کرے گا، لیکن اگر آپ لکھتے ہیں:

4 < 5

مارک ڈاؤن اسے اس میں تبدیل کر دے گا:

4 < 5

تاہم، یہ واضح رہے کہ کوڈ کے دائرہ کار میں، چاہے وہ ان لائن ہو یا بلاک، < 和 & دونوں علامتیںیقیناکو HTML اداروں میں تبدیل کر دیا جاتا ہے، ایک ایسی خصوصیت جو آپ کو مارک ڈاؤن میں آسانی سے HTML کوڈ لکھنے کی اجازت دیتی ہے (HTML کے برعکس، جہاں آپ تمام < 和 & HTML فائل میں HTML کوڈ لکھنے کے لیے سبھی کو HTML اداروں میں تبدیل کر دیا جاتا ہے۔ )

بلاک عنصر

پیراگراف اور لائن بریک

مارک ڈاؤن پیراگراف متن کی ایک یا زیادہ مسلسل لائنوں پر مشتمل ہوتا ہے، اس سے پہلے اور اس کے بعد ایک سے زیادہ خالی لائنیں ہوتی ہیں (خالی لائن کی تعریف یہ ہے کہ یہ ڈسپلے پر خالی نظر آتی ہے اور اسے خالی لائن سمجھا جاتا ہے۔ مثال کے طور پر، , اگر کسی لائن میں صرف خالی جگہیں اور ٹیبز ہوں تو لائن کو بھی خالی لائن سمجھا جائے گا)۔عام پیراگراف کو خالی جگہوں یا ٹیبز کے ساتھ انڈینٹ نہیں کیا جانا چاہیے۔

فقرہ "متعلق ایک یا زیادہ لکیروں پر مشتمل ہوتا ہے" دراصل یہ ظاہر کرتا ہے کہ مارک ڈاؤن پیراگراف کے اندر زبردستی نئی لائنوں (نئی لائنوں کو داخل کرنے) کی اجازت دیتا ہے، یہ ایک خصوصیت جو کہ دوسرے متن سے ایچ ٹی ایم ایل فارمیٹس سے مختلف ہے (بشمول حرکت پذیر قسم "کنورٹ لائن بریکس) " اختیار)، دوسرے فارمیٹس ہر لائن بریک میں تبدیل کر دیں گے۔ <br /> لیبل

اگر آپواقعیداخل کرنے کے لیے مارک ڈاؤن پر انحصار کرنا چاہتے ہیں۔ <br /> لیبلز کے لیے، داخل کرنے کی جگہ پر دو یا زیادہ اسپیس دبائیں اور پھر Enter دبائیں۔

درحقیقت، اسے پیدا کرنے میں تھوڑا زیادہ کام (اضافی جگہیں) درکار ہے۔ <br /> ، لیکن صرف "ہر نئی لائن کو تبدیل کیا جاتا ہے۔ <br />"یہ طریقہ مارک ڈاؤن میں مناسب نہیں ہے، مارک ڈاؤن میںaiL طرز کے بلاک کوٹس اور ملٹی پیراگراف کی فہرستیں نہ صرف زیادہ کارآمد ہیں بلکہ لائن بریک کے ساتھ ٹائپ سیٹ کرتے وقت پڑھنے میں بھی آسان ہیں۔

عنوان

مارک ڈاون ہیڈنگز کے لیے دو نحو کو سپورٹ کرتا ہے، Setext-like اور atx-like۔

سیٹ ٹیکسٹ کی طرح فارم نیچے لائن کے ساتھ فارم ہے، استعمال کرتے ہوئے = (اعلیٰ ترین عنوان) اور - (دوسرے آرڈر کے عنوانات)، مثال کے طور پر:

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

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

کسی بھی رقم = 和 - مؤثر ہو سکتا ہے.

Atx کی طرح فارم لائن کے شروع میں 1 سے 6 تک داخل کرتا ہے۔ # , عنوانات 1 سے 6 کے مطابق، مثال کے طور پر:

# 这是 H1

## 这是 H2

###### 这是 H6

آپ اختیاری طور پر ای ٹی ایکس جیسے ہیڈر کو "بند" کر سکتے ہیں، یہ خالصتاً جمالیات کے لیے ہے، اگر آپ اس طرح آرام دہ محسوس کرتے ہیں، تو آپ اسے لائن کے آخر میں شامل کر سکتے ہیں۔ #، جب لائن ختم ہوتی ہے۔ # نمبر کا آغاز جیسا ہونا ضروری نہیں ہے (لائن کے شروع میں پاؤنڈ حروف کی تعداد عنوان کی ترتیب کا تعین کرتی ہے):

# 这是 H1 #

## 这是 H2 ##

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

بلاک کوٹس بلاک کوٹس

مارک ڈاون مارک اپ بلاک کوٹس اسی طرح استعمال کیے جاتے ہیں جو ای میل میں استعمال ہوتے ہیں۔ > حوالہ جات کےاگر آپ ای میل کے خطوط میں اقتباسات سے واقف ہیں، تو آپ جانتے ہیں کہ مارک ڈاون فائل میں بلاک اقتباس کیسے بنانا ہے، جو ایسا لگتا ہے کہ آپ خود لائنوں کو توڑ دیتے ہیں، پھر شامل کریں > :

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

دوسرے الفاظ میں، یہ لائن کے آغاز میں ظاہر ہوتا ہےعددی مدت خالیاس سے بچنے کے لیے، آپ مدت سے پہلے ایک بیک سلیش شامل کر سکتے ہیں۔

1986\. What a great season.

区块 区块

پروگرام سے متعلق تحریر یا ٹیگ لینگویج سورس کوڈ میں عام طور پر پہلے سے ہی ٹائپ سیٹ کوڈ بلاکس ہوتے ہیں۔ عام طور پر، ہم نہیں چاہتے کہ یہ بلاکس عام پیراگراف فائلوں کی طرح ٹائپ سیٹ ہوں، لیکن انہیں ویسا ہی دکھائیں جیسے وہ ہیں۔ مارک ڈاؤن استعمال کرے گا۔ <pre> 和 <code> کوڈ بلاکس کو لپیٹنے کے لیے ٹیگز۔

مارک ڈاؤن میں کوڈ کے بلاکس بنانا اتنا ہی آسان ہے جتنا کہ 4 اسپیس یا 1 ٹیب کو انڈینٹ کرنا، مثال کے طور پر، درج ذیل درج کریں:

这是一个普通段落：

    这是一个代码区块。

مارک ڈاؤن میں تبدیل ہو جائے گا:

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

کوڈ بلاک میں، عام مارک ڈاؤن نحو کو تبدیل نہیں کیا جائے گا، جیسے کہ ستارے صرف ستارے ہیں، جس کا مطلب ہے کہ آپ مارک ڈاؤن نحو سے متعلق فائلوں کو مارک ڈاؤن نحو میں آسانی سے لکھ سکتے ہیں۔

تقسیم کرنے والا

可以 在 一行 中用 三个 以上 的 星 号 、 减号 、 底线 来 内 中间 插入分隔线

* * *

***

*****

- - -

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

سیکشن عنصر

لنک

مارک ڈاؤن لنک نحو کی دو شکلوں کی حمایت کرتا ہے: لائن میں和حوالہدو شکلیں

کسی بھی طرح سے، لنک ٹیکسٹ کو [مربع بریکٹ] کے ساتھ نشان زد کیا جاتا ہے۔

تخلیق کرنالائن میںاگر آپ لنک کا ٹائٹل ٹیکسٹ شامل کرنا چاہتے ہیں تو صرف یو آر ایل کے بعد ٹائٹل ٹیکسٹ کو ڈبل کوٹیشن مارکس کے ساتھ لپیٹ دیں، مثال کے طور پر:

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 سنگل اقتباسات میں بند لنک ٹائٹلز کو نظر انداز کرتا ہے۔

لنک یو آر ایل کو زاویہ بریکٹ میں بھی بند کیا جا سکتا ہے:

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

آپ اگلی سطر پر ٹائٹل انتساب بھی رکھ سکتے ہیں، یا کچھ انڈینٹیشن شامل کر سکتے ہیں، جو بہتر نظر آئے گا اگر URL بہت لمبا ہو:

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

یو آر ایل کی تعریف صرف اس وقت استعمال ہوتی ہے جب لنک تیار کیا جاتا ہے، اور فائل میں براہ راست ظاہر نہیں ہوتا ہے۔

لنک کی شناخت کے ٹیگز میں حروف، اعداد، وائٹ اسپیس اور اوقاف شامل ہو سکتے ہیں، لیکن ایسا نہیںنہیںیہ کیس حساس ہے، اس لیے درج ذیل دو روابط ایک جیسے ہیں:

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

لکھنے کے مندرجہ بالا دو طریقے درج ذیل ایچ ٹی ایم ایل تیار کریں گے۔

<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 سورس کوڈ داخل کرنا آسان ہو جاتا ہے، 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>&#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 text][id]

"id" تصویری حوالہ کا نام ہے، جس کی تعریف اسی طرح کی گئی ہے جیسے ایک لنک حوالہ:

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

ابھی تک، مارک ڈاؤن کے پاس تصویر کی چوڑائی اور اونچائی بتانے کا کوئی طریقہ نہیں ہے، اگر آپ کو ضرورت ہو تو آپ عام استعمال کر سکتے ہیں۔ <img> لیبل

اس کے علاوہ

آٹو لنک

مارک ڈاؤن نسبتاً مختصر خودکار لنکس کی شکل میں پروسیسنگ یو آر ایل اور ای میل میل باکسز کو سپورٹ کرتا ہے۔ جب تک وہ زاویہ بریکٹ میں بند ہیں، مارک ڈاؤن خود بخود اسے ایک لنک میں تبدیل کر دے گا۔عام 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\*

مارک ڈاون 支持 以下 这些 符号 前面 加上 反斜杠 来 帮助 插入 普通 的 的 符号 ：

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

مارک ڈاؤن فری ایڈیٹر

ونڈوز پلیٹ فارم

• مارک ڈاون پیڈ
• مارک پیڈ

میک پلیٹ فارم

• نرم

آن لائن ایڈیٹر

• ایم پی ایڈیٹر

براؤزر پلگ ان

• یہاں پلگ ان کو نشان زد کریں۔

*** اگر تجویز کرنے کے لیے کوئی بہتر مفت مارک ڈاؤن ایڈیٹر ہے، تو براہ کرم تاثرات پر توجہ دیں۔چن ویلیانگ،شکریہ!