पूरा पिटारा

§1.1इनलाइन चिह्न

Emphasis-पार्सिंग CJK-फ़्रेंडली है: चीनी विराम-चिह्न से सटा bold भी ठीक बंद होता है — **报文。**同时 दो नंगे तारांकनों की तरह नहीं, 报文。同时 की तरह रेंडर होता है। इटैलिक, स्ट्राइकथ्रू और inline code हमेशा की तरह चलते हैं; gemoji स्विच के साथ :sparkles: जैसा शॉर्टकोड ✨ बन जाता है। inline code के भीतर के अक्षर किसी पार्सिंग में हिस्सा नहीं लेते, इसलिए सिंटैक्स दिखाने का सुरक्षित रास्ता backtick ही है: **, $…$ और > [!note] — तीनों ज्यों के त्यों दिखते हैं। गद्य में तारांकन दिखाना हो तो escape कीजिए — *इस तरह* सादा रह जाता है।

§1.2विकीलिंक

wikilinks स्विच चालू हो, तो [[दोहरे-कोष्ठक]] वाले लिंक विकी की रीति से नोट-संग्रह के विरुद्ध हल होते हैं: id से (design-tokens), उपनाम से (boundaries उस नोट तक पहुँचता है जिसकी id three-way-split है), लेबल के साथ (शुरुआती गाइड)। जो लक्ष्य किसी नोट पर न बैठे, वह बिल्ड बिगाड़ने की जगह चिह्नित मृत-लिंक बनकर रेंडर होता है — और इंजन की check-wikilinks CLI उसे CI में रिपोर्ट करती है, जहाँ लिंक-सड़न की असली जगह है।

§1.3टेबल: चौड़ी हो तो स्क्रॉल, सँकरी हो तो कार्ड

छह या ज़्यादा कॉलमों वाली टेबल को सँकरे कंटेनर में हर पंक्ति एक कार्ड बनकर फिर से जमना चाहिए — हर सेल को दो अक्षरों में निचोड़ना नहीं। यह सात-कॉलम टेबल callout-वेरिएंटों की चीट-शीट भी है और उसी reflow की जीवित परीक्षा भी (खिड़की फ़ोन जितनी सँकरी करके देखिए):

डिफ़ॉल्ट शीर्षक अंग्रेज़ी हैं; साइट siteMarkdown के calloutLabels विकल्प से पूरा सेट बदल देती है, जैसे calloutLabels: { tip: 'अंतर्दृष्टि · Intuition' }। quote-सिंटैक्स में लिखा शीर्षक (> [!tip] मेरा शीर्षक) हमेशा जीतता है।

§2.1Callout: तीन वर्तनियाँ

पहली, Obsidian/GitHub वाली quote-सिंटैक्स (callouts: true से उपलब्ध; सादे Markdown में भी चलती है):

Obsidian का fold-चिह्न माना जाता है — > [!note]- मुड़ा हुआ रेंडर होता है, > [!note]+ खुला:

दूसरी, MDX में पैकेज का कंपोनेंट (astro-inkstone/components/Callout.astro, पाथ से import)। title के बिना यह वेरिएंट का वही डिफ़ॉल्ट लेबल दिखाता है जो quote-सिंटैक्स दिखाती है:

तीसरी, raw HTML — छहों वेरिएंट एक साथ (base.css के .callout नियमों से एक-एक कर मिलान करते हुए):

§2.2गणित

इनलाइन सूत्र पाठ में बैठते हैं: प्रकाशीय गहराई पढ़िए $\tau = \int \kappa \rho \, \mathrm{d}s$। डिस्प्ले-गणित तीन-लाइन रूप में लिखा जाता है ($$ अपनी-अपनी लाइन पर) — एक-लाइन रूप को रक्षक अस्वीकार करता है, क्योंकि वह चुपचाप छोटे इनलाइन सूत्र के रूप में छप जाता:

सूत्र की ज़मीन जान-बूझकर मुख्य पाठ से अलग काग़ज़ है, और थीम के साथ बदलती है। और हाँ — गद्य में डॉलर-भाव escape कीजिए: इस कॉफ़ी का दाम $3 है।

§3.1कोड फ़्रेम

title="…" वाले फ़ेंस को फ़ाइल-नाम की टाइटल-बार मिलती है; कोने का कॉपी-बटन साइट-भर में है। [!code ++] / [!code --] लाइन-एनोटेशन diff-ज़मीनों के रूप में रेंडर होते हैं:

def build_pipeline(opts):
    plugins = [remark_math]  
    plugins = [remark_gemoji, remark_math]  
    return assemble(plugins, guard=opts.guard)

collapse चिह्नित फ़्रेम मुड़ा हुआ शुरू होता है और खोलने पर ही जगह लेता है — लंबी कॉन्फ़िग-फ़ाइलों के लिए सही:

site:
  markdown:
    numbering: chapters
    math: true
    codeFrame: true
    mermaid: true
    callouts: true
    wikilinks: true
  styles:
    - astro-inkstone/styles/tokens.css
    - astro-inkstone/styles/base.css

दोहरी-थीम हाइलाइटिंग shiki से आती है, जो दोनों रंग-सेट एक साथ निकालता है; base.css एक ही जगह data-theme देखकर एक चुन लेती है — specificity की कोई रस्साकशी नहीं।

§3.2Mermaid आरेख

```mermaid फ़ेंस बिल्ड के समय सिर्फ़ एक प्लेसहोल्डर छोड़ता है; रेंडरर सिर्फ़ उन्हीं पन्नों पर dynamic import से लदता है जिन पर कोई आरेख है (बिना आरेख वाले पन्ने कुछ नहीं चुकाते), और थीम पलटने पर फिर से रेंडर करता है:

flowchart LR
  A["astro-inkbrush<br/>engine: editing / dialect / guard"] --> C["your site<br/>identity / routing / deploy"]
  B["astro-inkstone<br/>paper: tokens / styles / pipeline"] --> C
  A -. one shared dialect .-> B

§3.3GFM के अतिरिक्त

टास्क-सूचियाँ और पाद-टिप्पणियाँ GFM के साथ-साथ चलती हैं:

• टोकन import हो गए
• base.css import हो गई
• पहचान का पैलेट override होना बाक़ी

जिस दावे का स्रोत देना बनता हो, उसे पाद-टिप्पणी मिलती है।¹

§4.1इस पन्ने पर रक्षक क्या-क्या अस्वीकारता है

यह पन्ना बनता है — यही इस बात का प्रदर्शन है कि ऊपर की हर चीज़ सही-सलामत लिखी है। नीचे की वर्तनियाँ बिल्ड को वहीं-के-वहीं गिरा देतीं (एक आज़माइए, फिर npm run build):

• ऐसा emphasis-चिह्न जिसका जोड़ा न बैठे, जैसे लाइन के अंत में खुला छूटा **;
• एक-लाइन $$x$$ (तीन-लाइन रूप लिखिए);
• हाथ से क्रमांकित शीर्षक — इस अनुभाग का शीर्षक ## 9. रक्षक क्या-क्या… लिखते ही वह बिल्ड-समय के क्रमांकन से टकराता और पकड़ा जाता;
• MDX का आपके गद्य के braces निगल जाना: {0,1,2,3} सिर्फ़ 3 बनकर छपता, इसलिए रक्षक escape किया रूप {0,1,2,3} माँगता है;
• ऐसा सूत्र जो KaTeX से न बने (रक्षक हर सूत्र को strict मोड में दोबारा रेंडर करता है — लाल error-टेक्स्ट को शिप नहीं होने देता)।