---
title: परिचय
description: >-
  Blume एक ओपन-सोर्स, मार्कडाउन-फर्स्ट डॉक्यूमेंटेशन फ्रेमवर्क है जो Astro और Vite पर आधारित है — तेज़, AI-तैयार, और टेम्पलेट तक शून्य-कॉन्फ़िग।
sidebar:
  label: परिचय
  order: 0
---

एक फ़ोल्डर में Markdown या MDX डालें, `blume dev` चलाएँ, और एक प्रोडक्शन-ग्रेड डॉक्स साइट पाएँ — नेविगेशन, सर्च, थीमिंग, Open Graph इमेज, और एक समृद्ध कंपोनेंट लाइब्रेरी — बिना कोई ऐप बॉयलरप्लेट लिखे या उसका रखरखाव किए।

**[त्वरित शुरुआत](/docs/quickstart)**

Blume इंस्टॉल करें और मिनटों में अपना पहला पेज शिप करें।

**[कॉन्फ़िगरेशन](/docs/configuration)**

शीर्षक, थीम, सर्च, और डिप्लॉयमेंट को ट्यून करें।

## Blume क्यों मौजूद है [#why-blume-exists]

डॉक्स तेज़, AI-तैयार, और शून्य-कॉन्फ़िग होने चाहिए — यहाँ तक कि किसी स्टार्टर टेम्पलेट की ज़रूरत ही न पड़े। कुछ डॉक्स टूल आपको एक शब्द लिखने से पहले ही रखरखाव के लिए पूरा कोडबेस थमा देते हैं। दूसरे आपकी कंटेंट के इर्द-गिर्द टेम्पलेट बनाते हैं, लेकिन आपको अपनी मैनेज्ड सर्विस में बाँध देते हैं।

Blume दोनों दुनियाओं का सर्वश्रेष्ठ लेता है। फ्रेमवर्क ही टेम्पलेट है, इसलिए आप केवल अपनी कंटेंट को ही छूते हैं। जब आप कस्टमाइज़ करना चाहें, तो आप बिल्ट-इन कंपोनेंट्स को बदलकर, एकल कॉन्फ़िगरेशन फ़ाइल में संशोधन करके, या सीधे Astro साइट चाहने पर इजेक्ट करके भी शुरुआत कर सकते हैं। [FAQ](/docs/faq) में बताया गया है कि यह Mintlify, Fumadocs, और बाकी टूल्स की तुलना में कैसा है।

## Blume को अलग क्या बनाता है [#what-makes-blume-different]

### डिफ़ॉल्ट रूप से तेज़ [#fast-by-default]

Blume, Astro और Vite पर बनता है और डिफ़ॉल्ट रूप से स्टैटिक HTML रेंडर करता है — तेज़, कैश करने योग्य, और होस्ट करने में सस्ता। कोर थीम कोई क्लाइंट फ्रेमवर्क JS शिप नहीं करती, इसलिए पेज बॉक्स से बाहर ही Core Web Vitals पर अच्छा स्कोर करते हैं। डेव स्टार्टअप और हॉट रीलोड Vite-नेटिव महसूस होते हैं, और आप सर्वर फ़ीचर्स को केवल तभी चुनते हैं जब आपको उनकी ज़रूरत हो।

### बॉक्स से बाहर ही AI-तैयार [#ai-ready-out-of-the-box]

हर Blume साइट धाराप्रवाह मशीनी भाषा बोलती है। यह [`llms.txt` और `llms-full.txt`](/docs/discoverability/llms-txt) उत्सर्जित करती है, किसी भी पेज के URL में `.md` जोड़कर उसका कच्चा Markdown परोसती है, [OpenAPI द्वारा वर्णित एक JSON API](/docs/discoverability/json-api) उजागर करती है, और पाठकों को हर पेज पर **Copy as Markdown** और **Open in chat** क्रियाएँ देती है। एक वैकल्पिक इन-पेज **Ask AI** असिस्टेंट जोड़ें, या एक [**MCP सर्वर**](/docs/discoverability/mcp) होस्ट करें ताकि Claude Code और Cursor जैसे कोडिंग एजेंट आपके डॉक्स को सीधे सर्च और पढ़ सकें — कोई स्क्रैपिंग नहीं, कोई होस्टेड सर्विस नहीं। आपका Markdown इंसानों और मॉडल दोनों के लिए सत्य का स्रोत है।

### शून्य कॉन्फ़िगरेशन — यहाँ तक कि टेम्पलेट भी [#zero-configuration--even-the-template]

डॉक्स का एक फ़ोल्डर ही एक संपूर्ण प्रोजेक्ट है। क्लोन करने के लिए कोई स्टार्टर नहीं, सेट अप करने के लिए कोई Astro या Tailwind नहीं, और रखरखाव के लिए कोई टेम्पलेट नहीं। नेविगेशन आपकी फ़ाइलों से अनुमानित होता है, [सर्च](/docs/configuration/search) बिना किसी होस्टेड सर्विस के डेव और प्रोडक्शन में काम करता है, और थीमिंग मुट्ठी भर टोकन्स भर है। हर चीज़ का एक समझदार डिफ़ॉल्ट है; कॉन्फ़िगरेशन वह चीज़ है जिस तक आप पहुँचते हैं, वह नहीं जिससे आप शुरुआत करते हैं।

### जड़ तक टाइप-सेफ [#type-safe-to-the-core]

आपकी [`blume.config.ts`](/docs/configuration) और हर [`meta.ts`](/docs/content/meta) असली TypeScript हैं — एक स्कीमा द्वारा मान्य और `defineConfig` तथा `defineMeta` के साथ लिखी गईं। आपका एडिटर हर विकल्प को ऑटोकम्प्लीट करता है और टाइपो, अमान्य मान, तथा गायब फ़ील्ड्स को टाइप करते ही पकड़ लेता है, बिल्ड से बहुत पहले। कॉन्फ़िगरेशन ऐसा कोड है जिसे आप रीफैक्टर कर सकते हैं, कंप्यूट कर सकते हैं, और भरोसा कर सकते हैं — न कि ढीले-टाइप वाला YAML।

## सब कुछ शामिल [#everything-included]

- **कंपोनेंट्स** — कॉलआउट, कार्ड, स्टेप्स, टैब्स, अकॉर्डियन, बैज, फ़ाइल ट्री, और पैरामीटर टेबल, MDX में [बिना किसी इम्पोर्ट](/docs/content/components) के उपयोग योग्य।
- **लोकल सर्च** — Orama डेव और प्रोडक्शन में काम करता है; बड़ी साइटों के लिए Pagefind एक फ़्लैग भर दूर है। कोई होस्टेड इंडेक्स नहीं।
- **AI** — [`llms.txt`, कच्चे Markdown URL, OpenAPI विवरण के साथ एक JSON API, Copy as Markdown, Open in chat, और एक होस्टेड MCP सर्वर](/docs/discoverability), साथ ही एक वैकल्पिक [Ask AI असिस्टेंट](/docs/configuration/ask-ai)।
- **नेविगेशन** — फ़ाइलों से अनुमानित, `meta.ts` या कॉन्फ़िग से परिष्कृत।
- **SEO** — मेटाडेटा, Open Graph इमेज, RSS फ़ीड, और JSON-LD, [बिल्ट इन](/docs/discoverability)।
- **कस्टमाइज़ेशन** — कंपोनेंट ओवरराइड, React आइलैंड्स, कस्टम पेज, थीम टोकन्स, और `blume add` के ज़रिए एक सोर्स-कंपोनेंट रजिस्ट्री।
- **इजेक्ट** — `blume eject` एक स्टैंडअलोन Astro प्रोजेक्ट तैयार करता है जो अब भी `blume` पैकेज का उपयोग करता है।

## यह कैसे काम करता है [#how-it-works]

Blume CLI आपकी कंटेंट खोजता है, एक कंटेंट ग्राफ़ बनाता है, और `.blume/` के अंतर्गत एक छिपा हुआ Astro प्रोजेक्ट जनरेट करता है जिसे वह डेव और बिल्ड के लिए चलाता है। जनरेट किया गया रनटाइम एक कार्यान्वयन विवरण है — आप Markdown लिखते हैं, बाकी सब Blume संभालता है — जब तक आप इजेक्ट करके उसका स्वामित्व लेने का निर्णय न लें।

## अगले कदम [#next-steps]

**[कॉन्फ़िगरेशन](/docs/configuration)**

शीर्षक, थीम, सर्च, और डिप्लॉयमेंट को ट्यून करें।

**[कंपोनेंट्स](/docs/content/components)**

बिल्ट-इन कंपोनेंट लाइब्रेरी का अन्वेषण करें।

**[खोज-योग्यता](/docs/discoverability)**

`llms.txt`, सोशल कार्ड, और एक MCP सर्वर शिप करें।

**[CLI](/docs/reference/cli)**

हर `blume` कमांड और फ़्लैग।