Markdown سے HTML

یہ Markdown کو CommonMark اور GitHub Flavored Markdown (GFM) استعمال کرتے ہوئے HTML میں تبدیل کرتا ہے، جہاں سافٹ لائن بریکس <br> کے طور پر رینڈر ہوتے ہیں۔ آپ رینڈرڈ پیش منظر دیکھ سکتے ہیں، یا جنریٹ ہونے والے ٹیگز کا معائنہ کرنے کے لیے HTML-سورس ویو پر جا سکتے ہیں۔ آؤٹ پٹ بلاگ پلیٹ فارمز، ای میل ٹولز، یا کہیں بھی جہاں HTML قبول ہو پیسٹ کرنے کے لیے موزوں ہے۔

مثال

انپٹ Markdown:

# Release notes

We shipped **three** things this week:

- [x] Faster cold start
- [ ] Dark mode (next week)

See the [docs](https://example.com/docs) for details.

```js
console.log("hello");
```

رینڈر شدہ HTML سورس:

<h1>Release notes</h1>
<p>We shipped <strong>three</strong> things this week:</p>
<ul>
<li><input type="checkbox" checked disabled> Faster cold start</li>
<li><input type="checkbox" disabled> Dark mode (next week)</li>
</ul>
<p>See the <a href="https://example.com/docs">docs</a> for details.</p>
<pre><code class="language-js">console.log("hello");
</code></pre>

عام غلطیاں اور نقصانات

Markdown رینڈرنگ کے زیادہ تر حیرت انگیز نتائج چند سِنٹیکس جالوں سے آتے ہیں۔ اگر پیش منظر غلط نظر آئے تو ان میں سے ایک عموماً وجہ ہوتی ہے۔

• فہرست سے پہلے خالی لائن غائب۔ "Intro text\n- item" ایک پیراگراف کے طور پر رینڈر ہوتا ہے۔ انٹرو اور پہلی فہرست آئٹم کے درمیان ایک خالی لائن رکھیں۔
• پیراگراف چاہیے تھا مگر انڈینٹ والا کوڈ بلاک بن گیا۔ چار ابتدائی اسپیس کسی بھی لائن کو کوڈ بلاک بنا دیتے ہیں۔ انڈینٹ ہٹائیں یا صراحت سے fenced ``` بلاک استعمال کریں۔
• ٹوٹا ہوا ٹیبل۔ ہر GFM ٹیبل کو ایک سیپریٹر رو (| --- | --- |) درکار ہوتی ہے جس میں ہر کالم میں کم از کم تین ڈیش ہوں، اور ہر رو پر برابر تعداد میں پائپ ہوں۔
• URL میں اسپیس والا لنک۔ [click](my page.html) پارسر توڑ دیتا ہے۔ اسپیس کو %20 کے طور پر URL-انکوڈ کریں یا اینگل بریکٹس استعمال کریں: <my page.html>۔
• الفاظ کے اندر ستارے۔ wild*card آس پاس کے متن پر منحصر ہو کر زور کے طور پر رینڈر ہو بھی سکتا ہے اور نہیں بھی۔ بیک اسلیش سے اسکیپ کریں: wild\*card۔
• کوڈ بلاکس کے اندر HTML اسکیپنگ۔ &lt; کے ساتھ پیسٹ کیے گئے سنپٹس لفظی دکھتے ہیں کیونکہ وہ پہلے ہی اسکیپڈ ہیں۔ اسکیپنگ سے پہلے کچا سورس پیسٹ کریں۔

یہ کون سا Markdown فلیور سپورٹ کرتا ہے؟

CommonMark کے ساتھ GitHub Flavored Markdown (GFM)۔ یہ ٹیبلز، fenced کوڈ بلاکس، ٹاسک لسٹس، اسٹرائیک تھرو، اور آٹو لنکڈ URLs کو کور کرتا ہے۔ پیراگراف کے اندر لائن بریکس <br> ٹیگز بن جاتے ہیں کیونکہ breaks آپشن فعال ہے — یہ اس طرز سے میل کھاتا ہے جس طرح GitHub اور زیادہ تر چیٹ ایپس کمنٹس رینڈر کرتی ہیں۔

کیا میرے Markdown کا HTML سینی ٹائز ہوتا ہے؟

نہیں۔ رینڈرڈ پیش منظر بائے ڈیفالٹ خام HTML کو گزار دیتا ہے۔ یہ ایمبیڈڈ <details> یا <kbd> جیسی چیزوں کو چلتا رکھتا ہے۔ بغیر DOMPurify جیسے سینی ٹائزر سے گزارے ناقابلِ اعتبار Markdown پیسٹ کرکے نتیجہ عوامی سائٹ پر نہ ڈالیں۔

کیا فٹ نوٹس، ریاضی، یا ڈایاگرام سپورٹڈ ہیں؟

نہیں۔ یہ سادہ GFM ہے۔ فٹ نوٹس، ریاضی (KaTeX/MathJax)، اور Mermaid ڈایاگرام GitHub یا پلیٹ فارم ایکسٹینشنز ہیں اور یہاں رینڈر نہیں ہوتے۔ اگر درکار ہوں تو متعلقہ پلگ انز کے ساتھ کنفیگرڈ Markdown رینڈرر استعمال کریں، یا نتیجہ ایسے پلیٹ فارم پر پیسٹ کریں جو انہیں رینڈر کرے۔

HTML کاپی کرنے پر کیا ہوتا ہے؟

رینڈرڈ HTML سورس Clipboard API کے ذریعے آپ کے کلپ بورڈ پر لکھا جاتا ہے۔ آپ کو صفحے کی ریپنگ کے بغیر HTML ملتا ہے — صرف وہ ٹیگز جو آپ کے Markdown کی نمائندگی کرتے ہیں۔ کسی CMS، ای میل ایڈیٹر، یا براہِ راست فائل میں پیسٹ کریں۔ ڈسک پر کوئی فائل نہیں بنتی۔

میرے ٹیبلز بے ترتیب کیوں لگتے ہیں؟

GFM ٹیبلز کو ہیڈر رو، ہر کالم میں کم از کم تین ڈیش والی سیپریٹر رو، اور سیلز کے درمیان پائپس درکار ہیں۔ گمشدہ پائپ یا صرف دو ڈیش والی سیپریٹر رو خاموشی سے ناکام ہو جاتی ہے۔ یہ دیکھنے کے لیے کہ واقعی <table> بنی ہے یا نہیں، HTML سورس ویو پر جائیں۔

کیا آپ یہاں پیسٹ کی گئی Markdown محفوظ کرتے ہیں؟

نہیں۔ ہم آپ کی ٹائپ یا پیسٹ کی گئی کوئی Markdown محفوظ نہیں کرتے، اور ڈاؤن لوڈ کی گئی رینڈرڈ HTML بھی نہیں رکھتے۔ ٹیب بند یا ریفریش ہوتے ہی سب کچھ ضائع — کوئی لاگ نہیں، آپ نے کیا لکھا اس کا ہمارے پاس کوئی ریکارڈ نہیں۔ چاہیں تو براؤزر کے DevTools چیک کریں۔