مقالې لارښود
نښه کولڅه مانا؟
د مارک ډاون ترکیب/فارمیټینګ مارک اپ څنګه وکاروئ؟
عمومي کتنه
مارک ډاون د لږ وزن لرونکي مارک اپ ژبه ده چې د جان گروبر لخوا رامینځته شوې.
دا خلکو ته اجازه ورکوي چې "په ساده متن کې اسناد ولیکئ چې لوستل او لیکل اسانه دي، او بیا یې په معتبر 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
مارک ډاون به دا بدل کړي:
AT&T
ورته حالت په کې هم واقع کیږي < نوټیشن، ځکه چې مارک ډاون د HTML مطابقت ته اجازه ورکوي، که تاسو یې واچوئ < سمبولونه د HTML ټګونو لپاره د حد په توګه کارول کیږي، او مارک ډاون به په دوی کې هیڅ ډول تبادله ونه کړي، مګر که تاسو ولیکئ:
4 < 5
مارک ډاون به دا بدل کړي:
4 < 5
په هرصورت، دا باید په پام کې ونیول شي چې د کوډ په ساحه کې، ایا دا انلاین یا بلاک دی، < 和 & دواړه سمبولونهبایدد HTML ادارو ته بدل شوي، یو ځانګړتیا چې تاسو ته اجازه درکوي په اسانۍ سره په مارک ډاون کې د HTML کوډ ولیکئ (د HTML سره مخالف، چیرته چې تاسو ټول < 和 & ټول په HTML ادارو کې بدل شوي، په HTML فایل کې د HTML کوډ لیکلو لپاره. )
د بلاک عنصر
پاراګرافونه او د کرښې ماتول
د مارک ډاون پراګراف د متن یو یا څو پرله پسې کرښې لري، مخکې او وروسته له یوې څخه ډیرې خالي کرښې (د خالي کرښې تعریف دا دی چې دا په ښکاره کولو کې خالي ښکاري او خالي کرښه ګڼل کیږي. د بیلګې په توګه، ، که چیرې یوه کرښه یوازې ځایونه او ټبونه ولري ، نو لاین به هم د خالي کرښې په توګه وګڼل شي).نورمال پراګرافونه باید د ځایونو یا ټبونو سره نه وي.
عبارت "د متن د یو یا څو پرله پسې لینونو څخه جوړه ده" په حقیقت کې دا معنی لري چې مارک ډاون په پراګرافونو کې د جبري نوي لاینونو (نوی لاینونو داخلولو) ته اجازه ورکوي، یو داسې ځانګړتیا چې د نورو متن څخه تر HTML فارمیټونو کې توپیر لري (پشمول د حرکت وړ ډول "د لاین بریکونو بدلول. " اختیار)، نور فارمیټونه به د هرې کرښې بریک ته بدل کړي <br /> 标签.
که تهپه حقیقت کید ننوتلو لپاره په مارک ډاون تکیه کول غواړئ <br /> د لیبلونو لپاره، د ننوتلو ځای کې دوه یا ډیر ځایونه فشار ورکړئ او بیا Enter فشار ورکړئ.
په حقیقت کې، دا د تولید لپاره یو څه نور کار (اضافي ځایونه) اخلي <br /> ، مګر په ساده ډول "هر نوی لاین ته بدل شوی <br />"دا طریقه په مارک ډاون کې مناسبه نه ده، په مارک ډاون کېaiد L طرز بلاک کوټونه او څو پاراګراف لیستونه نه یوازې ډیر ګټور دي بلکه لوستل یې هم اسانه دي کله چې د لاین بریکونو سره ټایپ سیټینګ.
سرلیک
مارک ډاون د سرلیکونو لپاره دوه ترکیبونه ملاتړ کوي ، د سیټیک په څیر او د اټکس په څیر.
د Settext په څیر فورمه هغه فورمه ده چې د لاندینۍ کرښې سره کارول کیږي = (تر ټولو لوړ عنوان) او - (د دوهم نظم سرلیکونه)، د بیلګې په توګه:
This is an H1
=============
This is an H2
-------------
هره اندازه = 和 - اغیزمن کیدی شي.
د Atx په څیر فورمه د کرښې په پیل کې له 1 څخه تر 6 پورې داخلوي # د 1 څخه تر 6 پورې سرلیکونو سره مطابقت لري، د بیلګې په توګه:
# 这是 H1
## 这是 H2
###### 这是 H6
تاسو کولی شئ په اختیاري توګه د ایټیکس په څیر سرلیکونه "بند" کړئ، دا په بشپړ ډول د جمالیات لپاره دی، که تاسو پدې ډول آرامۍ احساس کوئ، تاسو کولی شئ دا د کرښې په پای کې اضافه کړئ. #په داسې حال کې چې کرښه پای ته رسیږي # شمیره باید د پیل سره ورته نه وي (د کرښې په پیل کې د پونډ حروفونو شمیر د سرلیک ترتیب ټاکي):
# 这是 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.
په بل عبارت، دا د کرښې په پیل کې ښکاريشمیره دوره خالید دې څخه د مخنیوي لپاره، تاسو کولی شئ د دورې څخه مخکې یو بیک سلیش اضافه کړئ.
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 سرچینې کوډ دننه کولو لپاره د Markdown کارول خورا اسانه کوي، یوازې دا کاپي او پیسټ کړئ، انډیټیشن اضافه کړئ، او پاتې مارک ډاون به ستاسو لپاره اداره کړي. بېلګه:
<div class="footer">
© 2004 Foo Corporation
</div>
به بدل شي:
<pre><code><div class="footer">
© 2004 Foo Corporation
</div>
</code></pre>
د کوډ بلاک کې، عمومي مارک ډاون ترکیب به نه بدلیږي، لکه ستوري یوازې ستوري دي، پدې معنی چې تاسو کولی شئ په اسانۍ سره په مارک ډاون ترکیب کې د مارک ډاون ترکیب اړوند فایلونه ولیکئ.
ویشونکی
تاسو کولی شئ د دریو څخه ډیرو ستورو، منفي نښو، په یوه لیکه کې د انډر سکورونو سره یو ویشونکی جوړ کړئ، په لیکه کې بل څه نشته.تاسو کولی شئ د ستوري یا منفي نښو ترمینځ ځایونه هم دننه کړئ.د جلا کولو کرښې د لیکلو په لاندې لارو کې رامینځته کیدی شي:
* * *
***
*****
- - -
---------------------------------------
برخه عنصر
لینک
مارک ډاون د لینک ترکیب دوه ډوله ملاتړ کوي: انلاین和حوالهدوه بڼې.
په هرصورت، د لینک متن د [مربع بریکٹ] سره نښه شوی.
د جوړولو لپارهانلاینکه تاسو غواړئ د لینک سرلیک متن اضافه کړئ، یوازې د 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 په واحد نرخونو کې تړل شوي لینک سرلیکونه له پامه غورځوي.
د لینک 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 بڼه کې، د متن څخه ډیر ټاګونه شتون لري.
د مارک ډاون د حوالې سټایل لینکونو په کارولو سره ، تاسو کولی شئ سند د براوزر وروستۍ پایلې په څیر رامینځته کړئ ، تاسو ته اجازه درکوي د پراګراف متن بهر ځینې مارک اپ پورې اړوند میټاډاټا حرکت وکړئ ، او تاسو کولی شئ لینکونه اضافه کړئ پرته لدې چې د مقالې لوستلو احساس رامینځته کړئ. .
ټینګار وکړئ
مارک ډاون ستوري کاروي (*) او لاندینۍ کرښه (_) د یو سمبول په توګه د نښه شوي کلمې نښه کول، is * یا یا _ محاصره شوي کلمې په کې بدلیږي <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>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>
انځور
په ښکاره ډول، یوازې د متن غوښتنلیک کې د انځورونو داخلولو لپاره د "طبیعي" ترکیب ډیزاین کول ستونزمن دي.
مارک ډاون د عکسونو نښه کولو لپاره لینکونو ته ورته ترکیب کاروي ، او دوه سټایلونو ته هم اجازه ورکوي: انلاین和حواله.
د انلاین عکس ترکیب داسې ښکاري:
جزیات په لاندې ډول دي:
- د تعجب نښه
! - د عکس لپاره د 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> tag)، تاسو کولی شئ د بیک سلیش سره ستوری مخکې کړئ:
\*literal asterisks\*
مارک ډاون د لاندې سمبولونو ملاتړ کوي چې د بیک سلیش څخه مخکې د عام سمبولونو دننه کولو کې مرسته کوي:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号د مارک ډاون وړیا مدیر
د وینډوز پلیټ فارم
د ماک پلیټ فارم
آنلاین مدیر
د براوزر پلگ ان
*** که چیرې د وړاندیز کولو لپاره غوره وړیا مارک ډاون ایډیټر شتون ولري ، مهرباني وکړئ فیډبیک ته پاملرنه وکړئچن ویلینګ،مننه!
امید چن وییلینګ بلاګ ( https://www.chenweiliang.com/ ) شریک کړل "مارک ډاون څه معنی لري؟ د مارک ډاون ترکیب/فارمیټینګ مارک اپ څنګه وکاروئ؟ ، ستاسو سره د مرستې لپاره.
د دې مقالې لینک شریکولو ته ښه راغلاست:https://www.chenweiliang.com/cwl-482.html