--- title: सिंटैक्स description: >- हर Markdown और MDX फ़ीचर जिसे Blume रेंडर करता है — फ़ॉर्मेटिंग, सूचियाँ, टेबल, कॉलआउट, कोड ब्लॉक, पैकेज इंस्टॉल, और गणित। --- Blume मानक Markdown और MDX को एक सुव्यवस्थित, GitHub-फ़्लेवर्ड फ़ीचर सेट के साथ रेंडर करता है — कोई इम्पोर्ट नहीं, कोई कॉन्फ़िगरेशन नहीं। कंटेंट उसी तरह लिखें जैसे आप पहले से लिखते हैं; यह पेज वह सब कुछ दिखाता है जो समर्थित है, हर एक के लाइव प्रीव्यू और सोर्स के साथ। ## शीर्षक [#headings] शीर्षकों से पेज को संरचित करें। Blume आपके फ़्रंटमैटर के `title` को पेज शीर्षक के रूप में रेंडर करता है, इसलिए अपना कंटेंट `##` से शुरू करें — `##` और `###` विषय-सूची में प्रविष्टियाँ बन जाते हैं। हर `##`–`######` शीर्षक अपने ही एंकर के लिंक में लपेटा जाता है, ताकि पाठक किसी शीर्षक पर क्लिक करके सीधे उस अनुभाग का परमालिंक कॉपी, बुकमार्क या साझा कर सकें (`#` दिखाने के लिए होवर करें)। इसे बंद करने के लिए `blume.config.ts` में `markdown: { headingAnchors: false }` सेट करें। ```md ## Section ### Subsection #### Detail ``` ### कस्टम एंकर [#custom-anchors] एंकर आईडी शीर्षक के पाठ से उत्पन्न होती हैं, इसलिए शब्द बदलने पर शीर्षक को नई एंकर मिल जाती है। इसके बजाय एंकर को स्थिर करने के लिए `[#custom-id]` जोड़ें — यह मार्कर कभी रेंडर नहीं होता, और शीर्षक चाहे जैसा भी पढ़ा जाए, लिंक काम करते रहते हैं। स्थिर की गई एंकर [अनूदित लोकेल](/docs/content/i18n) में भी एक जैसी रहती हैं, जबकि स्वतः उत्पन्न आईडी हर भाषा में अलग-अलग होतीं। ```md ## Getting started [#setup] ``` इसे `/page#setup` के रूप में लिंक करें। यह सिंटैक्स Fumadocs से मेल खाता है, इसलिए माइग्रेट किया गया कंटेंट ज्यों का त्यों काम करता है। Pandoc, kramdown, और Markdown-आधारित विनिर्देश टूलचेन द्वारा उपयोग किया जाने वाला `{#custom-id}` रूप `.md` फ़ाइलों में समकक्ष के रूप में स्वीकार किया जाता है। `.mdx` में, अकेला `{…}` एक JSX एक्सप्रेशन होता है और पेज कंपाइल होने में विफल हो जाता है — `blume check` इस मार्कर को `BLUME_MDX_CURLY_ANCHOR` के रूप में रिपोर्ट करता है — इसलिए वहाँ `[#custom-id]` लिखें, या ब्रेसेस को एस्केप करें। एस्केप किया गया रूप दोनों फ़ॉर्मैट में एक ही एंकर स्थिर करता है, जिससे यह उस पार्शियल के लिए सही वर्तनी बन जाता है जिसे `.mdx` पेज [इनक्लूड](/docs/content/includes) करते हैं: ```md ## Getting started \{#setup\} ``` फ़्रैगमेंट लिंक `id` वाले किसी रॉ HTML एलिमेंट (``) को भी लक्षित कर सकते हैं; `blume validate` उन्हें शीर्षक एंकर के साथ-साथ स्वीकार करता है। ### विषय-सूची मार्कर [#table-of-contents-markers] दो और अनुगामी मार्कर यह नियंत्रित करते हैं कि कोई शीर्षक विषय-सूची में कैसे दिखे। `[!toc]` शीर्षक को पेज पर रखता है पर TOC से बाहर; `[toc]` इसका उलटा करता है — शीर्षक केवल TOC में दिखता है, एक अदृश्य एंकर लक्ष्य के रूप में, जो गद्य के बजाय कंपोनेंट्स से बने अनुभागों को लेबल करने के लिए उपयोगी है। मार्कर किसी भी क्रम में जोड़े जा सकते हैं। एक अपवाद, जो CommonMark से विरासत में मिला है: ऐसा अनुगामी ब्रैकेट जिसके लेबल की कोई लिंक-रेफ़रेंस परिभाषा पेज पर कहीं भी मौजूद हो (`[toc]: /url`), वह मार्कर नहीं बल्कि एक शॉर्टकट रेफ़रेंस लिंक होता है और शीर्षक के पाठ में बना रहता है। ```md ## Appears on the page only [!toc] ## Appears in the TOC only [toc] ## Both markers together [toc] [#custom-id] ``` मार्कर हमेशा पार्स होते हैं — ऐसा शीर्षक जो शाब्दिक रूप से मार्कर-जैसे पाठ पर समाप्त होता है, चिह्नित माना जाएगा। बैकस्लैश-एस्केपिंग से मदद नहीं मिलती (मार्कर पार्स चलने से पहले Markdown `\[` को `[` में हल कर देता है); किसी शीर्षक के अंत में शाब्दिक मार्कर पाठ दिखाने के लिए, उसे इनलाइन कोड में लपेटें: `` ## Using `[toc]` ``। ## ज़ोर [#emphasis] शब्दों पर ज़ोर देने, विलोपन चिह्नित करने, और वाक्य के बीच में कोड या कीस्ट्रोक दिखाने के लिए इनलाइन फ़ॉर्मेटिंग। **बोल्ड**, _इटैलिक_, ~~स्ट्राइकथ्रू~~, और `inline code`। ```md **Bold**, _italic_, ~~strikethrough~~, and `inline code`. ``` ## कीबोर्ड कुंजियाँ [#keyboard-keys] शॉर्टकट और कीस्ट्रोक के लिए। कोई `` एलिमेंट उसी बॉर्डर वाले की-बैज के रूप में रेंडर होता है जिसे सर्च डायलॉग उपयोग करता है — Markdown, MDX, और `` तथा `` जैसे कंपोनेंट्स के भीतर। सर्च खोलने के लिए ⌘ K दबाएँ, या उसे बंद करने के लिए Esc। ```md Press ⌘ K to open search, or Esc to close it. ``` ## सुपरस्क्रिप्ट और सबस्क्रिप्ट [#superscript-and-subscript] फ़ुटनोट चिह्नों, क्रमवाचक संख्याओं, और इनलाइन वैज्ञानिक या रासायनिक संकेतन के लिए। E = mc^2^ और H~2~O। {/* prettier-ignore */} ```md E = mc^2^ and H~2~O. ``` ## ब्लॉककोट [#blockquotes] किसी उद्धरण, कॉलआउट टिप्पणी, या संपादकीय नोट को आसपास के पाठ से अलग करें। > दस्तावेज़ीकरण जो तेज़, AI-रेडी, और शून्य-कॉन्फ़िग है — टेम्पलेट तक। ```md > Documentation that's fast, AI-ready, and zero-config — down to the template. ``` ## सूचियाँ [#lists] अक्रमित समूहों के लिए अक्रमित सूचियाँ, अनुक्रमों के लिए क्रमित सूचियाँ, और चेकलिस्ट व रोडमैप के लिए टास्क सूचियाँ इस्तेमाल करें। - Markdown-पहले लेखन - डिफ़ॉल्ट रूप से स्टैटिक - सर्वर फ़ीचर्स को चुनकर सक्षम करें - अपने आउटपुट के मालिक बनें 1. Blume इंस्टॉल करें 2. एक पेज लिखें 3. उसे शिप करें - [x] प्रोजेक्ट स्कैफ़ोल्ड करें - [ ] पहली गाइड लिखें ```md - Markdown-first authoring - Static by default - Opt into server features - Own your output 1. Install Blume 2. Write a page 3. Ship it - [x] Scaffold the project - [ ] Write the first guide ``` ## टेबल [#tables] संरचित डेटा को सारणीबद्ध करें — कॉन्फ़िग विकल्प, तुलना मैट्रिक्स, पैरामीटर सूचियाँ। कॉलम संरेखित करने के लिए विभाजक पंक्ति में कोलन का उपयोग करें। | कमांड | विवरण | आउटपुट | | ------------- | ------------------- | :-----: | | `blume dev` | डेव सर्वर शुरू करें | — | | `blume build` | स्टैटिक साइट बनाएँ | `dist/` | ```md | Command | Description | Output | | ------------- | --------------------- | :-----: | | `blume dev` | Start the dev server | — | | `blume build` | Build the static site | `dist/` | ``` हेडर पंक्ति के बिना टेबल के लिए — जैसे कुंजी–मान जोड़े — हेडर सेल्स खाली छोड़ दें। Markdown को सिंटैक्स के लिहाज़ से हेडर और विभाजक पंक्तियाँ चाहिए, लेकिन Blume रेंडर की गई टेबल से खाली हेडर हटा देता है। ```md | | | | -------------- | -------- | | Current status | E-3 visa | ``` ## लिंक और इमेज [#links-and-images] दूसरे पेजों या बाहरी साइटों से लिंक करें। इमेज आपके कंटेंट के बगल में मौजूद फ़ाइल का सापेक्ष पथ, `public/` के अंतर्गत कोई भी पथ (जो साइट रूट पर सर्व होता है), या कोई रिमोट URL स्वीकार करती हैं। शुरू करने के लिए [क्विकस्टार्ट](/docs/quickstart) पढ़ें। ```md Read the [quickstart](/docs/quickstart) to get started. ![Alt text](./screenshot.png) ``` **स्थानीय इमेज के लिए सापेक्ष पथ को प्राथमिकता दें** — वे बिल्ड समय पर ऑप्टिमाइज़ होती हैं: कंप्रेस, WebP में परिवर्तित, और अंतर्निहित `width`/`height` के साथ अंकित, ताकि लोड होते समय पेज खिसके नहीं। इमेज को उसी पेज के बगल में रखें जो उसका उपयोग करता है (या अपनी कंटेंट डायरेक्टरी के भीतर किसी साझा फ़ोल्डर में) और उसे सापेक्ष रूप से संदर्भित करें: ```md ![Build output](./images/build-output.png) ``` `public/` के अंतर्गत निरपेक्ष पथ (`![Alt text](/screenshot.png)`) बिना किसी ऑप्टिमाइज़ेशन के ज्यों का त्यों सर्व होते हैं — उन्हें उन फ़ाइलों के लिए इस्तेमाल करें जिनके बाइट्स और URL बिल्कुल वैसे ही रहने चाहिए, जैसे आपके डॉक्स के बाहर से संदर्भित कोई लोगो। रिमोट इमेज भी बिना छेड़छाड़ के पास कर दी जाती हैं, बशर्ते उनका होस्ट [`image` कॉन्फ़िग](/docs/configuration#images) में अधिकृत न हो। कंटेंट इमेज डिफ़ॉल्ट रूप से क्लिक-टू-ज़ूम होती हैं — पाठक किसी भी इमेज पर क्लिक करके उसे लाइटबॉक्स में खोल सकते हैं। इसे `blume.config.ts` में `markdown: { imageZoom: false }` से बंद करें, या किसी एक इमेज को `data-no-zoom` से बाहर रखें। ## क्षैतिज रेखा [#horizontal-rule] एक लंबे पेज के भीतर विषय के बड़े बदलावों को अलग करें। --- ```md --- ``` ## कोड ब्लॉक [#code-blocks] फ़ेंस किए गए कोड ब्लॉक सिंटैक्स-हाइलाइट होते हैं, जिनके हेडर में भाषा दिखती है — पहचानी गई भाषाओं के लिए ब्रांड आइकन के साथ — और एक कॉपी बटन होता है। भाषा के बाद एक **शीर्षक** जोड़ें — आमतौर पर फ़ाइल नाम — और यह हेडर में भाषा लेबल की जगह ले लेता है। ```ts blume.config.ts import { defineConfig } from "blume"; export default defineConfig({ title: "My docs", }); ``` ````md ```ts blume.config.ts import { defineConfig } from "blume"; export default defineConfig({ title: "My docs", }); ``` ```` इनलाइन कोड को भी हाइलाइट किया जा सकता है: बैकटिक स्पैन के भीतर एक `{:lang}` मार्कर जोड़ें और वह किसी छोटे कोड ब्लॉक की तरह रंगीन हो जाता है — `useState(){:js}` या `T extends object{:ts}`। यह तभी सक्रिय होता है जब आप मार्कर जोड़ें, इसलिए सादा इनलाइन कोड अछूता रहता है — चालू करने के लिए कुछ नहीं। हाइलाइटिंग डिफ़ॉल्ट रूप से `github-light`/`github-dark` थीम का उपयोग करती है। `markdown.codeBlocks.theme` से प्रति कलर मोड कोई भी [बंडल की गई Shiki थीम](https://shiki.style/themes) बदलें — यह एक साथ हर कोड सतह को रंगती है (फ़ेंस, इनलाइन स्निपेट, ``, और ``): ```ts blume.config.ts export default defineConfig({ markdown: { codeBlocks: { theme: { light: "github-light", dark: "vesper" }, }, }, }); ``` आप सीधे एक कस्टम [Shiki थीम परिभाषा](https://shiki.style/guide/load-theme) भी दे सकते हैं। VS Code-संगत थीम JSON फ़ाइल इम्पोर्ट करें (यदि आपके रनटाइम को आवश्यक हो तो इम्पोर्ट एट्रिब्यूट के साथ) और उसे किसी भी कलर मोड को असाइन करें; बंडल किए गए नाम और कस्टम परिभाषाएँ मिलाई जा सकती हैं: ```ts blume.config.ts import darkTheme from "./themes/acme-dark.json" with { type: "json" }; export default defineConfig({ markdown: { codeBlocks: { theme: { light: "github-light", dark: darkTheme }, }, }, }); ``` ### लाइन नंबर [#line-numbers] लाइन-नंबर गटर रेंडर करने के लिए `lineNumbers` जोड़ें — अकेले या किसी शीर्षक के साथ: ```ts server.ts lineNumbers import { serve } from "blume"; serve({ port: 3000 }); ``` ````md ```ts server.ts lineNumbers import { serve } from "blume"; serve({ port: 3000 }); ``` ```` ### हाइलाइटिंग [#highlighting] लाइनों, शब्दों और बदलावों पर ध्यान खींचने के लिए कोड को GitHub-शैली की टिप्पणियों से एनोटेट करें। ये टिप्पणियाँ रेंडर किए गए आउटपुट से हटा दी जाती हैं, इसलिए कोड कॉपी-पेस्ट के लिए साफ़ रहता है। चारों डिफ़ॉल्ट रूप से चालू हैं — कोई कॉन्फ़िगरेशन नहीं। किसी लाइन को हाइलाइट की गई पृष्ठभूमि देने के लिए उसे `// [!code highlight]` से चिह्नित करें: ```ts const config = defineConfig({ title: "My docs", // [!code highlight] }); ``` जोड़ के लिए `// [!code ++]` और हटाने के लिए `// [!code --]` से बदलाव दिखाएँ, जो हरे/लाल डिफ़ के रूप में रेंडर होते हैं: ```ts export default defineConfig({ title: "My docs", // [!code --] title: "Blume docs", // [!code ++] }); ``` किसी लाइन में किसी शब्द की हर आवृत्ति को `// [!code word:serve]` से हाइलाइट करें: ```ts import { serve } from "blume"; // [!code word:serve] serve({ port: 3000 }); ``` `// [!code focus]` से चिह्नित लाइनों को छोड़कर बाकी सब धुँधला कर दें (होवर करने पर बाकी स्पष्ट हो जाता है): ```ts export default defineConfig({ title: "My docs", // [!code focus] description: "Built with Blume", }); ``` या टिप्पणियों के बजाय **नंबर** से लाइनें हाइलाइट करें — तब उपयोगी जब आप कोड संपादित न कर सकें। भाषा के बाद एक ब्रेस रेंज रखें; एकल लाइनें, अल्पविराम से अलग सूचियाँ, और `start-end` स्पैन — सभी काम करते हैं: ```ts {1,4-5} import { defineConfig } from "blume"; export default defineConfig({ title: "My docs", description: "Built with Blume", }); ``` ````md ```ts {1,4-5} import { defineConfig } from "blume"; export default defineConfig({ title: "My docs", description: "Built with Blume", }); ``` ```` ### डिस्प्ले प्रकार [#display-types] कंपाइलर से सीधे असली टाइप दिखाने के लिए किसी TypeScript ब्लॉक को `twoslash` से चिह्नित करें — [Twoslash](https://shiki.style/packages/twoslash) द्वारा संचालित। किसी भी टोकन पर होवर करके उसका अनुमानित टाइप देखें, और लाइन के नीचे कोई टाइप पिन करने के लिए इनलाइन `^?` क्वेरी जोड़ें। ```ts twoslash const config = { title: "My docs", version: 1, }; config.title; // ^? ``` ````md ```ts twoslash const config = { title: "My docs", version: 1 }; config.title; // ^? ``` ```` ### TypeScript और JavaScript टैब [#typescript-and-javascript-tabs] किसी `ts` या `tsx` ब्लॉक को `ts2js` से चिह्नित करें ताकि वह टैब जोड़ी के रूप में रेंडर हो: आपका TypeScript और उसके साथ स्वतः उत्पन्न JavaScript संस्करण, ताकि आप एक ही स्निपेट संभालें और पाठक अपनी बोली चुन लें। यह रूपांतरण टाइप सिंटैक्स और केवल-टाइप इम्पोर्ट हटा देता है, जबकि आपकी फ़ॉर्मेटिंग, टिप्पणियाँ, और JSX ठीक वैसे ही रखता है जैसे लिखे गए हैं — और टैब सिंक होते हैं, इसलिए एक बार JavaScript चुनने से पेज की हर जोड़ी बदल जाती है। डायग्राम और गणित की तरह, यह भी केवल-MDX फ़ीचर है — किसी `.md` फ़ाइल में यह ब्लॉक एक सादे TypeScript फ़ेंस के रूप में रेंडर होता है। ```ts ts2js import { defineConfig } from "blume"; interface Author { name: string; } const author: Author = { name: "Hayden" }; export default defineConfig({ title: `${author.name}'s docs`, }); ``` ````md ```ts ts2js import { defineConfig } from "blume"; interface Author { name: string; } const author: Author = { name: "Hayden" }; export default defineConfig({ title: `${author.name}'s docs`, }); ``` ```` अन्य फ़ेंस मेटा भी साथ काम करता है: `title="..."` दोनों टैब पर दिखता है, जबकि `{1,4-5}` लाइन रेंज केवल TypeScript टैब पर लागू होती हैं (टाइप हटने के बाद लाइन नंबर खिसक जाते हैं)। एकमात्र अपवाद `twoslash` है — होवर टाइप उत्पन्न कोड तक नहीं ले जाए जा सकते, इसलिए दोनों से चिह्नित फ़ेंस एक सादा Twoslash ब्लॉक ही रहता है। :::note `blume.config.ts` में `markdown: { code: { icons: false, wrap: true } }` से भाषा आइकन छिपाएँ या लंबी लाइनों को स्क्रॉल करने के बजाय रैप करें। ::: ## पैकेज इंस्टॉल [#package-install] एक `package-install` ब्लॉक एकल इंस्टॉल कमांड को npm, pnpm, yarn, bun, nub, और aube के लिए टैब वाले स्निपेट में बदल देता है — ताकि पाठक वही कॉपी करें जो उनके सेटअप से मेल खाता है। डायग्राम और गणित की तरह, यह भी केवल-MDX फ़ीचर है — किसी `.md` फ़ाइल में यह ब्लॉक एक सादे कोड फ़ेंस के रूप में रेंडर होता है। ```package-install npm i blume ``` ````md ```package-install npm i blume ``` ```` ## डायग्राम [#diagrams] एक `mermaid` ब्लॉक सीधे टेक्स्ट से [Mermaid](https://mermaid.js.org) डायग्राम रेंडर करता है। फ़ेंस की सामग्री ज्यों की त्यों Mermaid को दी जाती है, इसलिए Mermaid द्वारा समर्थित हर डायग्राम प्रकार यहाँ काम करता है। डायग्राम सक्रिय कलर थीम का अनुसरण करते हैं और थीम बदलने पर फिर से रेंडर होते हैं। सोर्स को `mermaid` से फ़ेंस करके कोई डायग्राम लिखें: ````md ```mermaid flowchart LR A[Markdown] --> B{blume build} B --> C[Static HTML] B --> D[llms.txt] ``` ```` डायग्राम क्लाइंट पर रेंडर होते हैं, इसलिए यह केवल-MDX फ़ीचर है, और Mermaid लाइब्रेरी केवल उन्हीं पेजों पर लोड होती है जिनमें कोई डायग्राम हो; जिस साइट में कोई डायग्राम नहीं है, वह इसे बिल्कुल भी शिप नहीं करती। डायग्राम डिफ़ॉल्ट रूप से Mermaid के dagre लेआउट और classic लुक का उपयोग करते हैं; Mermaid फ़्रंटमैटर (`layout: elk` या `look: neo` वाला एक `config:` ब्लॉक) के ज़रिए किसी एक डायग्राम के लिए कोई अन्य लेआउट या लुक चुनें, और ELK इंजन केवल उन्हीं डायग्राम के लिए लोड होता है जो उसकी माँग करते हैं। इस अनुभाग का बाकी हिस्सा सामान्य प्रकारों की एक गैलरी है — पूरी सूची के लिए [Mermaid डॉक्स](https://mermaid.js.org/intro/) देखें। ### फ़्लोचार्ट [#flowchart] ```mermaid flowchart LR A[Markdown] --> B{blume build} B --> C[Static HTML] B --> D[llms.txt] ``` ### सीक्वेंस डायग्राम [#sequence-diagram] ```mermaid sequenceDiagram participant R as Reader participant B as Blume R->>B: Request /docs B-->>R: Prerendered HTML ``` ### क्लास डायग्राम [#class-diagram] ```mermaid classDiagram class Page { +string title +string route +render() } Page <|-- Doc Page <|-- Changelog ``` ### स्टेट डायग्राम [#state-diagram] ```mermaid stateDiagram-v2 [*] --> Draft Draft --> Published: build Published --> [*] ``` ### एंटिटी रिलेशनशिप [#entity-relationship] ```mermaid erDiagram PAGE ||--o{ HEADING : contains PAGE { string title string route } ``` ### यूज़र जर्नी [#user-journey] ```mermaid journey title Publishing a page section Write Draft MDX: 5: Author section Ship blume build: 4: Author Deploy: 3: Author ``` ### गैंट [#gantt] ```mermaid gantt title Release plan dateFormat YYYY-MM-DD section Docs Draft :a1, 2026-01-01, 7d Review :after a1, 3d ``` ### गिट ग्राफ़ [#git-graph] ```mermaid gitGraph commit branch develop checkout develop commit checkout main merge develop commit ``` ### पाई चार्ट [#pie-chart] ```mermaid pie title Content types "Docs" : 70 "Blog" : 20 "Changelog" : 10 ``` ### माइंडमैप [#mindmap] ```mermaid mindmap root((Blume)) Content MDX Markdown Build Static HTML llms.txt ``` ### टाइमलाइन [#timeline] ```mermaid timeline title Blume milestones 2025 : Prototype 2026 : 1.0 release ``` ## कॉलआउट [#callouts] कॉलआउट पाठक का ध्यान संदर्भ, सलाह, या जोखिम की ओर खींचते हैं। उन्हें `:::type` डायरेक्टिव के रूप में लिखें; ब्रैकेट में शीर्षक जोड़ें, जैसे `:::warning[Heads up]`। डायरेक्टिव केवल-MDX फ़ीचर हैं — किसी `.md` फ़ाइल में `:::note` लाइन शाब्दिक पाठ ही रहती है। ### नोट [#note] तटस्थ, सहायक संदर्भ जिसे पाठक को ध्यान में रखना चाहिए। :::note Blume हर रन पर `.blume/` को फिर से बनाता है — इसे कभी हाथ से संपादित न करें। ::: ```md :::note Blume regenerates `.blume/` on every run — never edit it by hand. ::: ``` ### टिप [#tip] एक उपयोगी शॉर्टकट या सर्वोत्तम अभ्यास जो अनिवार्य नहीं है पर जीवन आसान बना देता है। :::tip `deployment.site` सेट करें ताकि साइटमैप और Open Graph इमेज निरपेक्ष URL का उपयोग करें। ::: ```md :::tip Set `deployment.site` so sitemaps and Open Graph images use absolute URLs. ::: ``` ### सफलता [#success] किसी सकारात्मक परिणाम की पुष्टि करें या यह कि कोई चरण अपेक्षा के अनुसार पूरा हुआ। :::success आपके डॉक्स सफलतापूर्वक बन गए और डिप्लॉय के लिए तैयार हैं। ::: ```md :::success Your docs built successfully and are ready to deploy. ::: ``` ### चेतावनी [#warning] ऐसी किसी बात को चिह्नित करें जिसमें गलती या अप्रत्याशित व्यवहार से बचने के लिए सावधानी चाहिए। :::warning[ध्यान दें] `output: "server"` पर स्विच करने के लिए डिप्लॉय करने से पहले एक एडाप्टर चाहिए। ::: ```md :::warning[Heads up] Switching to `output: "server"` requires an adapter before you can deploy. ::: ``` ### ख़तरा [#danger] ऐसी विध्वंसक या भंजक कार्रवाई को उजागर करें जिसे आसानी से पलटा नहीं जा सकता। :::danger `blume eject` एकतरफ़ा कदम है — उत्पन्न Astro प्रोजेक्ट आपका हो जाता है। ::: ```md :::danger `blume eject` is a one-way step — the generated Astro project becomes yours. ::: ``` ### जानकारी [#info] एक सूचनात्मक टिप्पणी; एक उपनाम-अनुकूल डिफ़ॉल्ट जो तटस्थ लगता है। :::info कोर थीम कोई क्लाइंट फ़्रेमवर्क JS शिप नहीं करती। ::: ```md :::info The core theme ships no client framework JS. ::: ``` `caution`, `error`, `important`, और `warn` नाम क्रमशः `warning`, `danger`, `note`, और `warning` के उपनाम के रूप में स्वीकार किए जाते हैं। ## गणित [#math] KaTeX के साथ LaTeX को केंद्रित ब्लॉक के रूप में रेंडर करें — गणित-प्रधान या वैज्ञानिक डॉक्स के लिए उपयोगी। किसी सूत्र को `$$…$$` में लपेटें: $$ \int_0^\infty e^{-x^2}\,dx = \frac{\sqrt{\pi}}{2} $$ ```md $$ a^2 + b^2 = c^2 $$ ``` :::note गणित केवल ब्लॉक-स्तर पर है और स्वतः चालू है — `$$…$$` लिखें और यह रेंडर हो जाता है; न लिखें तो KaTeX की स्टाइलशीट कभी शिप नहीं होती। इनलाइन `$…$` गणित नहीं है: अकेला `$` (मुद्रा, शेल वेरिएबल, कोड) हमेशा शाब्दिक पाठ ही रहता है, इसलिए न कोई डीलिमिटर एस्केप करना है और न कोई सेटिंग टॉगल करनी है। गणित एक केवल-MDX फ़ीचर है। रेंडर किए गए मार्कअप के भीतर के क्लास नाम (`.katex-html`, `.katex-base`, …) KaTeX के अपने आंतरिक विवरण हैं, कोई ऐसा स्टाइलिंग अनुबंध नहीं जिसे Blume बनाए रखता हो — KaTeX के अपग्रेड होने पर वे बदल सकते हैं, इसलिए कस्टम स्टाइल के लिए `.katex-display` रैपर को लक्षित करें। ::: ## स्मार्ट विराम-चिह्न [#smart-punctuation] Blume लिखते समय सीधे उद्धरण चिह्नों और डैश को टाइपोग्राफिक समकक्षों में बदल देता है, ताकि गद्य ऐसा पढ़ा जाए जैसे उसे टाइपसेट किया गया हो — किसी विशेष वर्ण की ज़रूरत नहीं। "उद्धरण" घुमावदार हो जाते हैं, -- एन डैश बन जाता है, --- एम डैश, और ... एक दीर्घवृत्त। ```md "Quotes" become curly, -- becomes an en dash, --- an em dash, and ... an ellipsis. ```