مارک ڈاؤن فائلوں میں ایچ ٹی ایم ایل

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

This sentence is in Markdown with a <b>bold inline HTML tag</b>.

ان لائن ایچ ٹی ایم ایل

ان لائن ایچ ٹی ایم ایل ٹیگز کو مارک ڈاؤن پیراگراف، فہرست آئٹم، یا ہیڈر میں استعمال کیا جا سکتا ہے، اور ان میں مارک ڈاؤن نحو بھی شامل ہو سکتا ہے (مثال کے طور پر، **strong** ، *emphasis* ، وغیرہ) یہ اس وقت مددگار ہوتا ہے جب آپ توجہ مبذول کروانا چاہتے ہیں تھوڑا سا کوڈ، جیسا کہ ذیل کی مثال میں ہے۔

This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>

بلاک سطح کا HTML

بلاک لیول کے ایچ ٹی ایم ایل ٹیگز جو DevSite کے ذریعے سپورٹ ہوتے ہیں انہیں خالی لائن کے ساتھ ارد گرد کے مواد سے الگ کیا جانا چاہیے۔ اور ان لائن ایچ ٹی ایم ایل ٹیگز کے برعکس، بلاک لیول کے ایچ ٹی ایم ایل ٹیگز میں مارک ڈاؤن نحو (مثلاً، **strong** ، *emphasis* ، وغیرہ) کو پیش نہیں کیا گیا جیسا کہ نیچے دی گئی مثال میں ہے۔

This is a Markdown paragraph that explains Java format strings:
                                  // required blank line
<pre>
  System.out.format("The square of *%d* is *%f*.*%n*", i, r);
</pre>
                                  // required blank line
This is another Markdown paragraph.

بہترین طریقے

ہم ڈیو سائیٹ پر رینڈرنگ کی خرابیوں کو روکنے کے لیے مندرجہ ذیل طریقوں سے مارک ڈاؤن فائلوں میں HTML کو فارمیٹ کرنے کی تجویز کرتے ہیں۔

غیر تعاون یافتہ بلاک لیول ایچ ٹی ایم ایل ٹیگز استعمال نہ کریں DevSite بہت سے بلاک لیول HTML ٹیگز کو سپورٹ کرتی ہے۔ لیکن ایک غیر تعاون یافتہ کو شامل کرنا یا تو آپ کے HTML کو متن کے طور پر پیش کرے گا یا کوڈ کو توڑ دے گا۔

بلاک لیول کے اسٹارٹ اور اینڈ ٹیگز کو انڈینٹ کرتے وقت اضافی ٹیبز یا اسپیس شامل نہ کریں ٹیبز یا اسپیس کے ساتھ انڈینٹ نہیں کیا جانا چاہیے۔ کچھ ایڈیٹرز خود بخود اضافی ٹیبز یا خالی جگہیں شامل کرتے ہیں — دھیان سے!

This is a regular paragraph in Markdown.

<p>
    This is an HTML paragraph with proper indentation!
</p>

This is a regular paragraph in Markdown.

یہ نہ بھولیں کہ انڈینٹڈ کوڈ رشتہ دار ہے۔

مثال کے طور پر، مارک ڈاؤن میں فہرستیں بناتے وقت آپ کو بلاک لیول کے آغاز اور اختتامی ٹیگز کو انڈینٹ کرنے کی ضرورت نہیں ہے۔

* This is a list item in Markdown

<p>This is an HTML paragraph with proper indentation!</p>

* This is a list item in Markdown

شروع اور اختتامی ٹیگ کے درمیان خالی لکیر شامل نہ کریں۔

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

This is a regular paragraph in Markdown.

<section>
  <p>
    hello
   </p>
  <p>
    hello
  </p>
</section>

This is a regular paragraph in Markdown.